Referência da linha de comando

Informar um problema Ver fonte Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

bazel [<startup options>] <command> [<args>]
ou
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Consulte o guia do usuário para a sintaxe de padrões de destino.

Sintaxe da opção

As opções podem ser transmitidas ao Bazel de diferentes maneiras. 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 abreviada de um único caractere. Nesse caso, a forma abreviada 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 desativado da seguinte maneira:
--no<option>
--<option>=[false|no|0]

As opções de três estados geralmente são definidas como automáticas por padrão e podem ser ativadas à força da seguinte maneira:

--<option>=[true|yes|1]
ou desativado à força da seguinte maneira:
--no<option>
--<option>=[false|no|0]

Comandos

analyze-profile Analisa dados de perfil de build.
aquery Analisa os destinos especificados e consulta o gráfico de ações.
build Cria os destinos especificados.
canonicalize-flags Canonicaliza uma lista de opções do Bazel.
clean Remove arquivos de saída e, opcionalmente, para o servidor.
coverage Gera um relatório de cobertura de código para os destinos de teste especificados.
cquery Carrega, analisa e consulta os destinos especificados com configurações.
dump Despeja o estado interno do processo do servidor bazel.
fetch Busca repositórios externos que são pré-requisitos para os destinos.
help Imprime ajuda para comandos ou o índice.
info Mostra informações de tempo de execução sobre o servidor do Bazel.
license Imprime a licença deste software.
mobile-install Instalações segmentadas para dispositivos móveis.
mod Consulta o gráfico de dependência externa do Bzlmod.
print_action Imprime 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 Para 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 Imprime informações da 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 ao JDK local para executar o servidor do Bazel e, em vez disso, sai.
Tags: affects_outputs, loses_incremental_state
--[no]batch padrão: "false"
Se definido, o Bazel será executado apenas como um processo de cliente sem um servidor, em vez do modo cliente/servidor padrão. Esse recurso está descontinuado e será removido. Se quiser evitar servidores persistentes, prefira desligar o servidor explicitamente.
Tags: loses_incremental_state, bazel_internal_configuration, deprecated
--[no]batch_cpu_scheduling padrão: "false"
Somente no Linux. Use o agendamento de CPU "em lote" para o Blaze. Essa política é útil para cargas de trabalho não interativas que não querem diminuir o valor nice. Consulte "man 2 sched_setscheduler". Se for "false", o Bazel não vai fazer 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 os valores padrão das opções do Bazel. /dev/null indica que todos os `--bazelrc`s futuros 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 usará o primeiro arquivo .bazelrc encontrado nos seguintes locais: o diretório do espaço de trabalho e o diretório inicial do usuário. Observação: as opções de linha de comando sempre substituem qualquer opção em 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 em stderr. Mudar essa opção não vai reiniciar o servidor.
Tags: affects_outputs, bazel_monitoring
--connect_timeout_secs=<an integer> padrão: "30"
O tempo que o cliente espera por 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 de 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 bazel será iniciado como um caminho absoluto. O processo do servidor será iniciado no cgroup especificado para cada controlador compatível. Por exemplo, se o valor dessa flag for /build/bazel e os controladores de CPU e memória estiverem 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 puder ser gravado 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 informá-la via 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 deve ou não procurar o arquivo bazelrc inicial em $HOME/.bazelrc
Tags: changes_inputs
--[no]idle_server_tasks padrão: "true"
Executar System.gc() quando o servidor estiver inativo
Tags: loses_incremental_state, host_machine_resource_optimizations
--[no]ignore_all_rc_files padrão: "false"
Desativa todos os arquivos rc, independente dos valores de outras flags que modificam o rc, mesmo que essas flags apareçam depois 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. Define um nível de 0 a 7 para o melhor esforço de programação de E/S usando a chamada de sistema sys_ioprio_set. 0 é a prioridade mais alta, e 7 é a mais baixa. O programador antecipatório só pode honrar até a prioridade 4. Se definido como um valor negativo, o Bazel não vai realizar uma chamada de sistema.
Tags: host_machine_resource_optimizations
Padrão de --local_startup_timeout_secs=<an integer>: "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 ao executar 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 mudanças. Os valores possíveis são: user-interactive, user-initiated, default, utility e background.
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 inatividade antes de ser desligado. Zero significa que o servidor nunca será desligado. Essa opção só é lida na inicialização do servidor. Mudar essa opção não vai reiniciar o servidor.
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 de uma invocação do Bazel para a próxima, provavelmente vai iniciar um novo servidor do Bazel adicional. 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, é possível ter várias bases de saída por espaço de trabalho e, assim, executar várias 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, é uma função de $USER, mas, ao especificar uma constante, as saídas de build podem ser compartilhadas entre usuários colaboradores.
Tags: affects_outputs, loses_incremental_state
--[no]preemptible padrão: "false"
Se for verdadeiro, o comando poderá ser substituído se outro comando for iniciado.
Tags: eagerness_to_exit
--[no]quiet padrão: "false"
Se for "true", nenhuma mensagem informativa será emitida no console, apenas erros. Mudar essa opção não vai reiniciar o servidor.
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 estiver 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 há algum tempo, desligue o servidor quando o sistema tiver pouca RAM livre. Somente no Linux.
Tags: eagerness_to_exit, loses_incremental_state
--[no]system_rc padrão: "true"
Se é necessário procurar o bazelrc em todo o sistema.
Tags: changes_inputs
--[no]unlimit_coredumps padrão: "false"
Aumenta o limite de coredump flexível para o limite rígido, permitindo coredumps do servidor (incluindo a JVM) e do cliente em condições comuns. Coloque essa flag no seu bazelrc uma vez e esqueça dela para receber coredumps quando encontrar uma condição que os acione.
Tags: bazel_internal_configuration
--[no]watchfs padrão: "false"
Se for verdadeiro, o Bazel vai tentar usar o serviço de observação de arquivos do sistema operacional para mudanças locais em vez de verificar todos os arquivos em busca de uma mudança.
Tags: deprecated
Se for "true", links simbólicos reais serão criados no Windows em vez de cópias de arquivos. É necessário ativar o modo de desenvolvedor do Windows e ter o Windows 10 versão 1703 ou mais recente.
Tags: bazel_internal_configuration
--[no]workspace_rc padrão: "true"
Se deve ou não procurar o arquivo bazelrc do espaço de trabalho em $workspace/.bazelrc
Tags: changes_inputs
Opções diversas, não categorizadas de outra forma.:
--host_jvm_args=<jvm_arg> vários usos são acumulados
Flags a serem transmitidas para a JVM que executa o Blaze.
--host_jvm_debug
Opção conveniente para adicionar algumas flags de inicialização da JVM, que fazem com que ela aguarde durante a inicialização até que você se conecte de um depurador compatível com JDWP (como o Eclipse) à porta 5005.
Expansão:
  --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 próprio Bazel.

Opções comuns a todos os comandos

Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path> vários usos são acumulados
Outros lugares para pesquisar arquivos antes de acessar a rede para fazer o download.
Tags: bazel_internal_configuration
Se definido, o cache do repositório vai criar um hardlink do arquivo em caso de acerto de cache, em vez de copiar. Isso serve para economizar espaço em disco.
Tags: bazel_internal_configuration
Padrão de --experimental_repository_downloader_retries=<an integer>: "5"
O número máximo de tentativas para repetir um erro de download. Se definido como 0, as novas tentativas serão desativadas.
Tags: experimental
Padrão de --experimental_scale_timeouts=<a double>: "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 esperado pelo autor da regra, sem mudar o código-fonte.
Tags: bazel_internal_configuration, experimental
Padrão de --http_connector_attempts=<an integer>: "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
Padrão de --http_max_parallel_downloads=<an integer>: "8"
O número máximo de downloads HTTP paralelos.
Tags: bazel_internal_configuration
Padrão de --http_timeout_scaling=<a double>: "1.0"
Ajusta 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 "false", as regras de repositório nativas 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 baixados 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 será permitido durante a busca do repositório. O acesso à rede não é completamente desativado. ctx.execute ainda pode executar um executável arbitrário que acessa 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
Padrão de --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
A porcentagem de espaço permanente ocupado (0 a 100) acima da qual o GcThrashingDetector considera eventos de pressão de memória em relação aos limites dele (--gc_thrashing_limits). Se definido como 100, o GcThrashingDetector será 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 for verdadeiro, as regras de linguagem proto vão definir toolchains 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 dela, e não a 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".
Expande 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.
Expande para:
  --remote_download_outputs=minimal

Tags: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> padrão: "toplevel"
Se definido como "minimal", não baixa nenhuma saída de build remoto para a máquina local, exceto as necessárias para ações locais. Se definido como "toplevel", se comporta como "minimal", exceto que também faz o download das saídas de destinos de nível superior para a máquina local. As duas opções podem reduzir significativamente os tempos de build se a largura de banda da rede for um gargalo.
Tags: affects_outputs
Em vez de baixar 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 são expandidos para o hash do objeto e o tamanho em bytes, respectivamente. Esses links simbólicos podem, por exemplo, apontar para um sistema de arquivos FUSE que carrega objetos do CAS sob demanda.
Tags: affects_outputs
--remote_download_toplevel
Faz o download apenas das saídas remotas de destinos de nível superior para a máquina local. Essa flag é um alias de --remote_download_outputs=toplevel.
Expande para:
  --remote_download_outputs=toplevel

Tags: affects_outputs
--repo_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica outras variáveis de ambiente que estarão disponíveis 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags etc.):
--[no]check_bzl_visibility padrão: "true"
Se estiver desativada, os erros de visibilidade de carga .bzl serã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 for verdadeiro, vai ativar o sistema de gerenciamento de dependências do Bzlmod, que terá 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 for "true", vai ativar 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() vão aceitar um parâmetro "resource_set" para execução local. Caso contrário, o padrão será 250 MB para memória e 1 CPU.
Tags: execution, build_file_semantics, experimental
--[no]experimental_bzl_visibility padrão: "true"
Se ativada, adiciona uma função "visibility()" que os arquivos .bzl podem chamar durante a avaliação de nível superior para definir a visibilidade deles com o objetivo de instruções load().
Tags: loading_and_analysis, experimental
--[no]experimental_cc_shared_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_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" vão estar 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 vai conseguir analisar o arquivo "external/BUILD", mas os globs que chegam a 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 verdadeiro, attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list() e rule(for_dependency_resolution=) serão permitidos.
Tags: build_file_semantics, experimental
--[no]experimental_enable_android_migration_apis padrão: "false"
Se definido como "true", 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 "true", os arquivos .scl poderão ser usados em instruções load().
Tags: build_file_semantics
--[no]experimental_google_legacy_api padrão: "false"
Se definido como "true", expõe várias partes experimentais da API de build do Starlark relacionadas ao código legado do Google.
Tags: loading_and_analysis, experimental
--[no]experimental_isolated_extension_usages padrão: "false"
Se for verdadeiro, vai ativar 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 úteis para depuração.
Tags: loading_and_analysis, experimental
--[no]experimental_repo_remote_exec padrão: "false"
Se definido como verdadeiro, repository_rule vai ganhar 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 "true", os repositórios não principais serão inseridos como symlinks no 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 não poderá incluir padrões de destino que possam se referir a mais de um pacote.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_allow_tags_propagation padrão: "true"
Se definido como "true", as tags serão propagadas de um destino para os requisitos de execução das ações. Caso contrário, as tags não serão propagadas. Consulte https://github.com/bazelbuild/bazel/issues/8830 para mais detalhes.
Tags: build_file_semantics, experimental
--[no]incompatible_always_check_depset_elements padrão: "true"
Verifique a validade dos elementos adicionados aos conjuntos de dependências em todos os construtores. Os elementos precisam ser imutáveis, mas historicamente o construtor depset(direct=...) se esqueceu de verificar. Use tuplas em vez de listas nos elementos de 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> default: "+@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 separada por vírgulas de regras (ou outros símbolos) que faziam parte do Bazel e agora precisam ser recuperadas dos respectivos repositórios externos. Essa flag foi criada para facilitar a migração de regras do Bazel. Consulte também https://github.com/bazelbuild/bazel/issues/23043. Um símbolo que é carregado automaticamente em um arquivo se comporta como se a definição integrada ao 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(). Para 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 sabe o novo local de definição em um repositório externo, bem como um conjunto de repositórios com tratamento especial que não podem ser carregados automaticamente para evitar a criação de ciclos. Um item de lista "+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 como 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 implementação antiga do Bazel de foo. Um item de lista "-foo" não aciona nenhum carregamento automático, mas torna a versão de foo definida pelo Bazel inacessível em todo o espaço de trabalho. 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 vai continuar funcionando normalmente. Nenhum carregamento automático será feito, nem a versão definida pelo Bazel será suprimida. Para configuração, consulte https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java. Como um atalho, todo o repositório também pode ser usado. Por exemplo, +@rules_python vai carregar automaticamente todas as regras do Python.
Tags: loses_incremental_state, build_file_semantics, incompatible_change
Quando verdadeiro, o Bazel não retorna mais uma lista de "linking_context.libraries_to_link", mas um depset.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disable_objc_library_transition padrão: "true"
Desative a transição personalizada do objc_library e herde do destino de nível superior (sem operação 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 poderão 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" usando a 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" de 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 "true", a chamada da API ctx.resolve_tools descontinuada sempre vai falhar. 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 "true", o valor padrão do argumento "allow_empty" de glob() será "False".
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 não poderão retornar uma struct. Em vez disso, eles precisam retornar uma lista de instâncias de provedor.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_enable_deprecated_label_apis padrão: "true"
Se ativadas, algumas APIs descontinuadas (native.repository_name, Label.workspace_name, Label.relative) poderão ser usadas.
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" em vez de "//..." para manter o comportamento antigo. Essa flag exige que --incompatible_package_group_has_public_syntax também esteja ativada.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_java_common_parameters padrão: "true"
Se definido como "true", os parâmetros output_jar e host_javabase em pack_sources e host_javabase em compile serão removidos.
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 usarão um ambiente obtido do ambiente de shell padrão, substituindo os valores transmitidos para "env". Se desativado, o valor de "env" será completamente ignorado nesse caso.
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 de origem (usados) serão particulares 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 for "true", os métodos em <code>repository_ctx</code> que recebem um rótulo não vão mais monitorar automaticamente o arquivo com esse rótulo para detectar mudanças, mesmo que <code>watch = "no"</code>, e <code>repository_ctx.path</code> não fará mais com que o caminho retornado seja monitorado. 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 "rule()" do Starlark.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_package_group_has_public_syntax padrão: "true"
No atributo "packages" de "package_group", permite escrever "public" ou "private" para se referir a todos os pacotes ou a nenhum pacote, respectivamente.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_require_linker_input_cc_api padrão: "true"
Se definido como "true", a regra "create_linking_context" vai exigir "linker_inputs" em vez de "libraries_to_link". Os antigos getters de linking_context também serão desativados, e apenas linker_inputs ficará 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 strings
Tags: build_file_semantics, incompatible_change
--[no]incompatible_simplify_unconditional_selects_in_rule_attrs padrão: "true"
Se for verdadeiro, simplifique os atributos de regra 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 de 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. Em vez disso, use ctx.label.package + '/BUILD'.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_stop_exporting_language_modules padrão: "false"
Se ativado, alguns módulos específicos do idioma (como "cc_common") não ficam disponíveis nos arquivos .bzl do usuário e só podem ser chamados dos 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 só será executado em destinos de nível superior cujos provedores anunciados pelas regras atendam aos provedores obrigatórios do aspecto.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_unambiguous_label_stringification padrão: "true"
Quando for "true", o Bazel vai transformar a string do 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. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15916.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc padrão: "false"
Quando for "true", o Bazel não vai mais permitir o uso de cc_configure em @bazel_tools. Consulte https://github.com/bazelbuild/bazel/issues/10134 para mais 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 a um depset (também conhecido como NestedSet), acima da qual o construtor de depset() vai falhar.
Tags: loading_and_analysis
--repositories_without_autoloads=<comma-separated set of options> padrão: ""
Uma lista de repositórios adicionais (além dos codificados que o Bazel conhece) em que os carregamentos automáticos não devem ser adicionados. Normalmente, ele contém repositórios que dependem transitivamente de um repositório que pode ser carregado automaticamente (e que, portanto, pode criar um ciclo).
Tags: loses_incremental_state, build_file_semantics, incompatible_change
Opções relacionadas à saída e à semântica do Bzlmod:
--allow_yanked_versions=<a string> vários usos são acumulados
Especifica as versões do módulo no formato<module1>@<version1>,<module2>@<version2> que serão permitidas no gráfico de dependência resolvido, mesmo que sejam declaradas como removidas no registro de origem (se não vierem de um NonRegistryOverride). Caso contrário, as versões removidas vão causar falha na resolução. Também é possível definir a versão removida permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. É possível desativar essa verificação usando a palavra-chave "all" (não recomendado).
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 falha de resolução, "off" para desativar a verificação ou "warning" para imprimir um aviso quando uma incompatibilidade for detectada.
Tags: loading_and_analysis
--check_direct_dependencies=<off, warning or error> padrão: "warning"
Verifique se as dependências diretas `bazel_dep` declaradas no módulo raiz são as mesmas versões que você recebe no gráfico de dependência resolvido. Os valores válidos são "off" para desativar a verificação, "warning" para imprimir um aviso quando uma incompatibilidade é detectada ou "error" para aumentar a gravidade e gerar uma falha na resolução.
Tags: loading_and_analysis
--[no]ignore_dev_dependency padrão: "false"
Se for "true", o Bazel vai ignorar "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 for 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 o arquivo de bloqueio será usado. Os valores válidos são "update" para usar o lockfile e atualizá-lo se houver mudanças, "refresh" para atualizar também informações mutáveis (versões removidas e módulos ausentes) de registros remotos de tempos em tempos, "error" para usar o lockfile, mas gerar um erro se ele não estiver atualizado, ou "off" para não ler nem gravar no lockfile.
Tags: loading_and_analysis
--override_module=<an equals-separated mapping of module name to path> vários usos são acumulados
Substitua um módulo com um caminho local no formato <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se 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.
--registry=<a string> vários usos são acumulados
Especifica os registros a serem usados para localizar dependências de módulos do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só vão recorrer aos registros posteriores quando estiverem faltando nos anteriores.
Tags: changes_inputs
--vendor_dir=<a path> padrão: consulte a descrição
Especifica o diretório que deve conter os repositórios externos no modo de fornecedor, seja para buscá-los ou usá-los durante a criação. 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 atingidos, fazem com que o GcThrashingDetector falhe no Bazel com um OOM. Cada limite é especificado como <período>:<contagem>, em que período é uma duração e contagem é um número inteiro positivo. Se mais de --gc_thrashing_threshold por cento do espaço permanente (heap da geração antiga) permanecer ocupado após <count> coletas de lixo completas consecutivas 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 for 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. Acreditamos que esses nós não serão mais necessários. Nesse caso, o programa vai reavaliá-los.
Tags: loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline padrão: "true"
Quando é "true", 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âmetros e quais não vão. Consulte https://github.com/bazelbuild/bazel/issues/7670 para mais detalhes.
Tags: loading_and_analysis, incompatible_change
--[no]keep_state_after_build padrão: "true"
Se for "false", o Blaze vai descartar o estado na memória dessa build quando ela terminar. Os builds subsequentes não terão incrementalidade em relação a este.
Tags: loses_incremental_state
Padrão de --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "10"
Flag para configuração avançada do mecanismo interno Skyframe 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 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 eventos de GC completo nunca vão acionar quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e esse limite de porcentagem de heap retido for excedido.
Tags: host_machine_resource_optimizations
Padrão de --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "10"
Flag para configuração avançada do mecanismo interno Skyframe do Bazel. Se o Bazel detectar que o uso percentual do heap retido excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC secundário, 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 de coleta de lixo secundários nunca vão acionar quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC secundário e esse 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 interno Skyframe do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retido está pelo menos nesse limite, ele vai descartar o estado temporário desnecessário do Skyframe. Ajustar isso pode ajudar a reduzir o impacto do tempo real do thrashing do GC, quando ele é (i) causado pelo uso da 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 "false", o Blaze não vai manter os dados que permitem a invalidação e a reavaliação em builds incrementais para economizar memória nesse build. Os builds subsequentes não terão incrementalidade em relação a este. Normalmente, você especifica --batch ao definir isso como "false".
Tags: loses_incremental_state
Opções que afetam a verbosidade, o formato ou o local do registro em log:
--[no]announce_rc padrão: "false"
Se as opções de rc devem ser 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 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 formato [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 para verificar se ele recebeu anteriormente eventos InvocationAttemptStarted e BuildEnqueued correspondentes ao evento da ferramenta atual.
Tags: affects_outputs
--bes_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho no formato NAME=VALUE que será incluído nas solicitações do BES. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para 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
--bes_keywords=<comma-separated list of options> vários usos 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
Padrão de --bes_oom_finish_upload_timeout=<An immutable length of time.>: "10m"
Especifica quanto tempo o Bazel deve esperar que o upload do BES/BEP seja concluído durante a falta de memória. Essa flag garante o encerramento quando a JVM está com thrashing de GC grave e não consegue progredir em nenhuma linha de execução do usuário.
Tags: bazel_monitoring
Padrão de --bes_outerr_buffer_size=<an integer>: "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 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 ao 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 ver as informações transmitidas para o back-end do BES. O Bazel vai enviar o URL anexado pelo ID de invocação ao terminal.
Tags: terminal_output
--bes_system_keywords=<comma-separated list of options> vários usos 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 via --bes_keywords. Destinado a operadores do 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 aguardar 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 por 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 Build Event Service 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_binary_file=<a string> padrão: ""
Se não estiver vazio, grave uma representação binária delimitada por varint da representação do protocolo de eventos 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"
Sempre que possível, converta caminhos na representação binária do protocolo de evento de build em URIs mais válidos globalmente. 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 Build Event Service 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 de 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"
Sempre que possível, converta os caminhos na representação do arquivo JSON do protocolo de eventos de build em URIs mais válidos globalmente. 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 Build Event Service 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
Padrão de --build_event_max_named_set_of_file_entries=<an integer>: "5000"
O número máximo de entradas para um único evento named_set_of_files. Valores menores que 2 são ignorados, e não é feita divisão de eventos. Isso limita o tamanho máximo do evento no protocolo de evento de build, embora 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 de hash.
Tags: affects_outputs
--[no]build_event_publish_all_actions padrão: "false"
Se todas as ações devem 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 de evento de build nesse arquivo
Tags: affects_outputs
--[no]build_event_text_file_path_conversion padrão: "true"
Sempre que possível, converta caminhos na representação do arquivo de texto do protocolo de evento de build em URIs mais válidos globalmente. Se desativado, o esquema de URI file:// sempre será 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 Build Event Service 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 deve tentar fazer upload de um evento de build.
Tags: bazel_internal_configuration
--[no]experimental_bep_target_summary padrão: "false"
Se os eventos TargetSummary devem ser publicados.
--[no]experimental_build_event_expand_filesets padrão: "false"
Se for verdadeiro, expanda os conjuntos de arquivos no BEP ao apresentar arquivos de saída.
Tags: affects_outputs
Se for "true", vai resolver totalmente os links simbólicos relativos do conjunto de arquivos no BEP ao apresentar arquivos de saída. Exige --experimental_build_event_expand_filesets.
Tags: affects_outputs
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both> vários usos são acumulados
Especifique como os arquivos de um grupo de saída serão representados em eventos BEP TargetComplete/AspectComplete. Os valores são uma atribuição de um nome de grupo de saída a um de "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 aparecer será usado. O valor padrão define o modo para artefatos de cobertura como "BOTH": --experimental_build_event_output_group_mode=baseline.lcov=both
Tags: affects_outputs
Padrão de --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
Delay inicial e mínimo para novas 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 dos artefatos referenciados no protocolo de eventos de build.
Tags: affects_outputs
--[no]experimental_collect_load_average_in_profiler padrão: "true"
Se ativado, o criador de perfil coleta a média geral de carga do sistema.
Tags: bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators padrão: "false"
Se ativado, o criador de perfis coleta os dados de PSI do Linux.
Tags: bazel_monitoring
--[no]experimental_collect_resource_estimation padrão: "false"
Se ativado, o criador de perfil 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 perfil coleta contagens de SkyFunction no gráfico do Skyframe ao longo do tempo para tipos de funções principais, como destinos configurados e execuções de ações. Pode ter um impacto na performance, já que visita o gráfico INTEIRO do Skyframe em todas as unidades de tempo de criação 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 criador de perfil coleta o uso da rede do sistema.
Tags: bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler padrão: "false"
Se ativado, o criador de perfil coleta dados agregados de recursos do worker.
Tags: bazel_monitoring
--experimental_command_profile=<cpu, wall, alloc or lock> padrão: consulte a descrição
Registra um perfil do Java Flight Recorder durante a execução do comando. Um dos tipos de eventos de criação de perfil compatíveis (cpu, wall, alloc ou lock) precisa ser fornecido como argumento. O perfil é gravado em um arquivo com o nome do tipo de evento no diretório base 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.
--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> vários usos são acumulados
Especifica outras tarefas de perfil a serem incluídas no perfil.
Tags: bazel_monitoring
--[no]experimental_profile_include_primary_output padrão: "false"
Inclui o atributo extra "out" 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 de 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 de perfil JSON dos eventos de ação.
Tags: bazel_monitoring
--[no]experimental_record_metrics_for_all_mnemonics padrão: "false"
Controla a saída de BEP ActionSummary e BuildGraphMetrics, limitando o número de mnemônicos em ActionData e o número de entradas informadas em BuildGraphMetrics.AspectCount/RuleClassCount. Por padrão, o número de tipos é limitado aos 20 principais, por número de ações executadas para ActionData e instâncias para RuleClass e Aspects. Definir essa opção grava estatísticas para todos os mnemônicos, classes de regras e aspectos.
--[no]experimental_record_skyframe_metrics padrão: "false"
Controla a saída de BEP BuildGraphMetrics, incluindo métricas caras para calcular o skyframe sobre Skykeys, RuleClasses e Aspects.Com essa flag definida como "false", BuildGraphMetrics.rule_count e aspectfields não serão preenchidos no BEP.
--[no]experimental_run_bep_event_include_residue padrão: "false"
Indica se o resíduo da linha de comando deve ser incluído em eventos de build de execução que podem conter o resíduo. Por padrão, o resíduo não é incluído em eventos de build de comandos de execução que podem conter o resíduo.
Tags: affects_outputs
--[no]experimental_stream_log_file_uploads padrão: "false"
Faça streaming dos uploads de arquivos de registro diretamente para o armazenamento remoto em vez de gravá-los no disco.
Tags: affects_outputs
--experimental_workspace_rules_log_file=<a path> padrão: consulte a descrição
Registra determinados eventos das regras do Workspace nesse arquivo como protos WorkspaceEvent delimitados.
--[no]generate_json_trace_profile padrão: "auto"
Se ativado, o Bazel cria um perfil do build e grava um perfil no formato JSON em um arquivo na base de saída. Para ver o perfil, carregue 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"
Se uma saída manual de um despejo de heap deve ser feita quando um OOM é gerado, 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 -XX:+HeapDumpOnOutOfMemoryError, que não tem efeito em 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 da coleta de memória de heap do JVM JDK21+. Estamos usando detalhes voláteis da implementação interna do G1 GC para receber uma métrica de memória limpa. Essa opção permite que nos adaptemos a mudanças nessa implementação interna sem precisar esperar por um lançamento binário. Transmitido para JDK Matcher.find()
--[no]legacy_important_outputs padrão: "false"
Use isso para suprimir a geração do campo legado "important_outputs" no evento "TargetComplete". Os "important_outputs" são necessários para a integração do Bazel com o ResultStore/BTX.
Tags: affects_outputs
Padrão de --logging=<0 <= an integer <= 6>: "3"
O nível de geração de registros.
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 das fases e heap estável no registro principal ao final da build.
Tags: bazel_monitoring
Padrão --memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>: "1,0"
Ajuste o cálculo 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 é a quantidade de GCs a serem realizados. O segundo número inteiro em cada par é o número de segundos a serem aguardados entre as GCs. Ex: 2,4,4,0 seriam 2 GCs com uma pausa de 4 segundos, seguidos por 4 GCs com pausa de zero 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 bazel analyze-profile para analisar o perfil.
Tags: bazel_monitoring
Padrão de --profiles_to_retain=<an integer>: "5"
Número de perfis a serem mantidos na base de saída. Se houver mais perfis 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 criador de perfil 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 um GRANDE impacto na performance. A opção só tem efeito se "--profile" também for usada.
Tags: bazel_monitoring
--[no]redirect_local_instrumentation_output_writes padrão: "false"
Se for verdadeiro e compatível, a saída da instrumentação será redirecionada para ser gravada localmente em uma máquina diferente daquela em que o Bazel está sendo executado.
Tags: bazel_monitoring
Padrão de --remote_print_execution_messages=<failure, success or all>: "failure"
Escolha quando imprimir mensagens de execução remota. Os valores válidos são "failure" (para imprimir apenas em caso de falha), "success" (para imprimir apenas em caso de sucesso) e "all" (para imprimir sempre).
Tags: terminal_output
--[no]slim_profile padrão: "true"
Reduz o tamanho do perfil JSON mesclando eventos se o perfil ficar muito grande.
Tags: bazel_monitoring
--starlark_cpu_profile=<a string> padrão: ""
Grava no arquivo especificado um perfil pprof do uso da CPU por todas as linhas de execução do Starlark.
Tags: bazel_monitoring
--tool_tag=<a string> padrão: ""
Um nome de ferramenta para atribuir a invocação do Bazel.
Tags: affects_outputs, bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters> vários usos são acumulados
Especifica quais eventos mostrar na interface. É possível adicionar ou remover eventos dos padrões usando +/- no início ou substituir o conjunto padrão completamente com atribuição direta. O conjunto de tipos de eventos compatíveis 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 "failure". Em um valor inválido para a opção, o comportamento é o mesmo que se a opção não estivesse definida.
Tags: execution
--experimental_downloader_config=<a string> padrão: consulte a descrição
Especifique um arquivo para configurar o downloader 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 fornecer várias diretivas `rewrite` para o mesmo URL. Nesse caso, vários URLs serão retornados.
--[no]experimental_guard_against_concurrent_changes padrão: "false"
Desative essa opção para desabilitar a verificação do ctime dos arquivos de entrada de uma ação antes de fazer upload para um cache remoto. Em alguns casos, o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
Padrão de --experimental_remote_cache_compression_threshold=<an integer>: "100"
O tamanho mínimo do blob necessário para compactar/descompactar com zstd. Não tem efeito, a menos que --remote_cache_compression esteja definido.
--[no]experimental_remote_cache_lease_extension padrão: "false"
Se definido como "true", o Bazel vai estender o lease 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`.
Padrão de --experimental_remote_cache_ttl=<An immutable length of time.>: "3h"
O TTL mínimo garantido de blobs no cache remoto depois que os resumos são referenciados recentemente, por exemplo, por um ActionResult ou FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs. Por exemplo, ele 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 quando 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 "true", descarta as cópias na memória da árvore de Merkle da raiz de entrada e os mapeamentos de entrada associados durante as chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso da memória, mas exige que o Bazel os recalcule em caso de falhas e novas tentativas de cache remoto.
--experimental_remote_downloader=<a string> padrão: consulte a descrição
Um URI de endpoint da API Remote Asset, a ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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"
Se é necessário voltar ao downloader local se o downloader remoto falhar.
--[no]experimental_remote_downloader_propagate_credentials padrão: "false"
Se as credenciais do netrc e do auxiliar de credenciais serão propagadas para o servidor de 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 no campo `uris` do FetchBlobRequest. Os cabeçalhos específicos do URL têm precedência sobre os globais.
--[no]experimental_remote_execution_keepalive padrão: "false"
Indica se o keepalive será usado para chamadas de execução remota.
Padrão de --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "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 como 0 significa que não há limitação.
Tags: execution
Padrão de --experimental_remote_failure_window_interval=<An immutable length of time.>: "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 é calculada como toda a duração da execução.As seguintes unidades 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 "true", o Bazel vai marcar as entradas como entradas de ferramentas para o executor remoto. Isso pode ser usado para implementar trabalhadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache padrão: "false"
Se definido como "true", os cálculos da árvore de Merkle serão memorizados para melhorar a velocidade de verificação de acertos do cache remoto. A pegada de memória do cache é controlada por --experimental_remote_merkle_tree_cache_size.
Padrão de --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
O número de árvores de Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrência em cache remoto. Embora o cache seja reduzido automaticamente de acordo com o processamento de referências leves do Java, erros de falta de memória podem ocorrer se o valor estiver muito alto. 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 remota. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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 "true", força o cache de todas as ações que podem ser executadas remotamente ou falha na build. Isso é útil para resolver problemas de não determinismo, porque permite verificar se as ações que devem ser armazenadas em cache são realmente armazenadas sem inserir novos resultados no cache.
--experimental_remote_scrubbing_config=<Converts to a Scrubber> padrão: consulte a descrição
Ativa a limpeza remota de chaves de cache com o arquivo de configuração fornecido, que precisa ser um buffer de protocolo em 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 segmentando a mesma plataforma. Ele precisa ser usado com muito cuidado, já que 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/de disco é calculada para recuperar ou armazenar um resultado de ação. As ações de limpeza não são compatí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, provavelmente você vai querer definir um --host_platform personalizado junto com --experimental_platform_in_output_dir (para normalizar prefixos de saída) e --incompatible_strict_action_env (para normalizar variáveis de ambiente).
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> padrão: "auto"
O modo de encadeamento a ser usado para buscar repositórios. Se definido como "off", nenhuma linha de execução de worker será usada, e a busca do repositório estará sujeita a reinicializações. Caso contrário, usa uma linha de execução de trabalho virtual.
--[no]remote_accept_cached padrão: "true"
Se os resultados de ações armazenados em cache remotamente devem ser aceitos.
--remote_build_event_upload=<all or minimal> padrão: "minimal"
Se definido como "all", todas as saídas locais referenciadas pelo BEP serão enviadas por upload para o cache remoto. Se definido como "minimal", as saídas locais referenciadas pelo BEP não serão enviadas para o cache remoto, exceto arquivos importantes para os consumidores do BEP (por exemplo, registros de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o URI dos arquivos, mesmo que eles estejam ausentes do 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 serem usados em URIs bytestream:// gravados em fluxos 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 cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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 for "true", 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 ainda podem bloquear mesmo quando essa flag está definida.
--[no]remote_cache_compression padrão: "false"
Se ativado, compacta/descompacta blobs de cache com zstd quando o tamanho deles for pelo menos --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações de cache: --remote_cache_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_default_exec_properties=<a 'name=value' assignment> vários usos são acumulados
Define as propriedades de execução padrão a 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: ""
Define as propriedades de plataforma padrão a serem definidas para a API Remote Execution, caso a plataforma de execução ainda não tenha 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.
--remote_download_regex=<a valid Java regular expression> vários usos são acumulados
Força o download de saídas de build remoto cujo caminho corresponda a esse padrão, independente de --remote_download_outputs. É possível especificar vários padrões repetindo essa flag.
Tags: affects_outputs
--remote_downloader_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações do downloader remoto: --remote_downloader_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_exec_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações de execução: --remote_exec_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para 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 UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--remote_grpc_log=<a path> padrão: consulte a descrição
Se especificado, é o caminho para um arquivo em que os detalhes relacionados à chamada gRPC serão registrados. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados. Cada mensagem tem como prefixo uma varint que indica o tamanho da seguinte mensagem protobuf serializada, conforme realizado pelo método LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações: --remote_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para 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"
Se é necessário voltar para a estratégia de execução local independente 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 mais detalhes.
Padrão de --remote_max_connections=<an integer>: "100"
Limita o número máximo de conexões simultâneas com o cache/executor remoto. Por padrão, o valor é 100. Definir 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 fazer até --remote_max_connections solicitações simultâneas. Para o cache/executor remoto do gRPC, um canal gRPC geralmente pode processar mais de 100 solicitações simultâneas. Assim, 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 a serem armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
Padrão de --remote_retries=<an integer>: "5"
O número máximo de tentativas para repetir um erro temporário. Se definido como 0, as novas tentativas serão desativadas.
Padrão de --remote_retry_max_delay=<An immutable length of time.>: "5s"
O atraso máximo de espera entre novas tentativas remotas. As seguintes unidades 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.
Padrão de --remote_timeout=<An immutable length of time.>: "60s"
O tempo máximo de espera para execução remota e chamadas de cache. Para o cache REST, esse é o tempo limite de conexão e de leitura. As seguintes unidades 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"
Se os resultados de ações executadas localmente devem ser enviados por upload para o cache remoto, caso ele seja compatível e o usuário tenha autorização para isso.
--[no]remote_verify_downloads padrão: "true"
Se definido como "true", 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:
--build_metadata=<a 'name=value' assignment> vários usos são acumulados
Pares de string de chave-valor personalizados a serem fornecidos em um evento de build.
Tags: terminal_output
--color=<yes, no or auto> padrão: "auto"
Use controles de terminal para colorir a saída.
--config=<a string> vários usos são acumulados
Seleciona seções de configuração adicionais 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 flags equivalentes estão localizadas nos arquivos de configuração tools/*.blazerc.
--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.> vários usos são acumulados
Configura um auxiliar de credenciais de acordo com a <a href="https://github.com/EngFlow/credential-helper-spec">especificação do auxiliar de credenciais</a> para usar na recuperação de credenciais de autorização para busca de repositório, execução e armazenamento em cache remoto e o serviço de eventos de build. As credenciais fornecidas por um helper têm precedência sobre as credenciais fornecidas por `--google_default_credentials`, `--google_credentials`, um arquivo `.netrc` ou o parâmetro auth para `repository_ctx.download()` e `repository_ctx.download_and_extract()`. Pode ser especificado várias vezes para configurar vários helpers. Consulte https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/ para ver instruções.
Padrão de --credential_helper_cache_duration=<An immutable length of time.>: "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 elas expiram.
Padrão de --credential_helper_timeout=<An immutable length of time.>: "10s"
Configura o tempo limite de um assistente de credenciais. Se os ajudantes de credenciais não responderem dentro desse período, a invocação vai falhar.
--curses=<yes, no or auto> padrão: "auto"
Use controles de 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ções. Se o diretório não existir, ele será criado.
--[no]enable_platform_specific_config padrão: "false"
Se for "true", o Bazel vai coletar linhas de configuração específicas do SO do host em arquivos bazelrc. Por exemplo, se o SO host for Linux e você executar "bazel build", o Bazel vai coletar 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 ficar inativo antes que uma coleta de lixo do cache de disco ocorra. 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 de disco será coletado periodicamente como lixo para remover entradas mais antigas que essa idade. Se definido em conjunto com --experimental_disk_cache_gc_max_size, os dois 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 de disco será coletado periodicamente para ficar abaixo desse tamanho. Se definido em conjunto com --experimental_disk_cache_gc_max_age, os dois 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.
--[no]experimental_rule_extension_api padrão: "true"
Ativar a API experimental de extensão de regra e as APIs de subregras
Tags: loading_and_analysis, experimental
--[no]experimental_windows_watchfs padrão: "false"
Se for verdadeiro, a compatibilidade experimental do Windows para --watchfs será ativada. Caso contrário, --watchfs é uma operação nula no Windows. Não se esqueça de ativar --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"
Se é necessário usar as "Credenciais padrão do aplicativo do Google" 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 manutenção de atividade para conexões gRPC de saída. Se definido, o Bazel envia pings após esse período sem operações de leitura na conexão, mas apenas se houver pelo menos uma chamada gRPC pendente. Os horários são tratados como granularidade de segundo. É um erro definir um valor menor que um segundo. Por padrão, os pings de manutenção de atividade estão desativados. Coordene 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
Padrão de --grpc_keepalive_timeout=<An immutable length of time.>: "20s"
Configura um tempo limite de manutenção de atividade para conexões gRPC de saída. Se os pings de atividade em tempo real estiverem ativados com --grpc_keepalive_time, o Bazel vai atingir o tempo limite de uma conexão se não receber uma resposta de ping após esse período. Os horários são tratados como granularidade de segundo. É um erro definir um valor menor que um segundo. Se os pings de manutenção de atividade estiverem desativados, essa configuração será ignorada.
--[no]incompatible_disable_non_executable_java_binary padrão: "false"
Se for verdadeiro, java_binary sempre será executável. O atributo create_executable será removido.
Tags: loading_and_analysis, incompatible_change
--inject_repository=<an equals-separated mapping of repository name to path> vários usos 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 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 caller. O UUID é impresso em stderr, no BEP e no protocolo de execução remota.
Tags: bazel_monitoring, bazel_internal_configuration
--override_repository=<an equals-separated mapping of repository name to path> vários usos 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 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"
Mostre o progresso do comando no título do terminal. Útil para ver o que o Bazel está fazendo quando há várias guias de 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
Especifique um caminho para um certificado TLS confiável para assinar certificados de servidor.
--tls_client_certificate=<a string> padrão: consulte a descrição
Especifique o certificado TLS do cliente a ser usado. Também é necessário fornecer uma chave do cliente para ativar a autenticação do cliente.
--tls_client_key=<a string> padrão: consulte a descrição
Especifique a chave do cliente TLS a ser usada. Também é necessário fornecer um certificado do cliente para ativar a autenticação do cliente.
Padrão de --ui_actions_shown=<an integer>: "8"
Número de ações simultâneas mostradas na barra de progresso detalhada. Cada ação aparece em uma linha separada. A barra de progresso sempre mostra pelo menos um, 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 for "true", o Bazel tentará usar o serviço de observação de arquivos do sistema operacional para mudanças locais em vez de verificar todos os arquivos em busca de uma mudança. No Windows, essa flag não faz nada, mas pode ser ativada junto 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"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, o formato ou o local do registro:
--dump=<text or raw> [-d] padrão: consulte a descrição
gera um despejo completo dos dados do perfil no formato "text" legível por humanos ou no formato "raw" compatível com scripts.
Tags: bazel_monitoring

Opções de Aquery

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"
Nenhuma operação.
Tags: loading_and_analysis
Opções relacionadas à saída e à semântica da consulta:
--aspect_deps=<off, conservative or precise> padrão: "conservative"
Como resolver dependências de aspectos quando o formato de saída é um dos seguintes: {xml,proto,record}. "off" significa que nenhuma dependência de aspecto é resolvida. "conservative" (o padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independente de terem recebido a classe de regra de dependências diretas. "precise" significa que apenas os aspectos possivelmente ativos são adicionados, considerando a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar uma única meta, o que o torna mais lento do que os outros modos. Além disso, mesmo o modo preciso não é completamente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante "bazel query".
Tags: build_file_semantics
--[no]consistent_labels padrão: "false"
Se ativado, todo comando de consulta vai emitir rótulos como se a função <code>str</code> do Starlark fosse aplicada a uma instância <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órios aparentes (em relação 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 por aspectos devem ser incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags: terminal_output
--[no]graph:factored padrão: "true"
Se for verdadeiro, o gráfico será emitido "fatorado", ou seja, nós topologicamente equivalentes serão mesclados e seus rótulos concatenados. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--graph:node_limit=<an integer> padrão: "512"
O comprimento máximo da string de rótulo para um nó de gráfico na saída. Rótulos mais longos serão truncados. -1 significa que não haverá truncamento. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--[no]implicit_deps padrão: "true"
Se ativadas, 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 é aquela que 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 por aspectos devem ser 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"
Inclua o conteúdo dos arquivos de parâmetros usados no comando (potencialmente grandes). Observação: ativar essa flag também ativa automaticamente a flag --include_commandline.
Tags: terminal_output
--[no]include_pruned_inputs padrão: "true"
Inclui entradas de ação que foram removidas durante a execução da ação. Afeta apenas 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", a barra dupla inicial "//" não será omitida.
Tags: terminal_output, incompatible_change
--[no]infer_universe_scope padrão: "false"
Se definido e --universe_scope não estiver definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão de 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 apenas se souber o que está fazendo. Acesse https://bazel.build/reference/query#sky-query para ver 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" (ou seja, não "cquery"). Tags do
: loading_and_analysis
--[no]line_terminator_null padrão: "false"
Indica se cada formato é encerrado com \0 em vez de uma 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 atributo "nodep" é "visibility". 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 precisam ser impressos. Os valores permitidos para aquery são: text, textproto, proto, streamed_proto, jsonproto.
Tags: terminal_output
--[no]proto:default_values padrão: "true"
Se for "true", os atributos cujo valor não estiver especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Essa opção se aplica 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 ativados, os atributos configuráveis criados por select() serão simplificados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa de seleção exatamente uma vez. Os tipos escalares são nivelados como nulos.
Tags: build_file_semantics
--[no]proto:include_attribute_source_aspects padrão: "false"
Preencha o campo proto source_aspect_name de cada atributo com o aspecto de origem de que o atributo veio (string vazia se não veio de nenhum).
Tags: terminal_output
--[no]proto:include_synthetic_attribute_hash padrão: "false"
Se o atributo $internal_attr_hash deve 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 exige que a pilha esteja presente.
Tags: terminal_output
--[no]proto:locations padrão: "true"
Se é necessário gerar informações de localização na saída proto.
Tags: terminal_output
Padrão de --proto:output_rule_attrs=<comma-separated list of options>: "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 e, para a primeira regra com um determinado "rule_class_key", preencha também o campo proto "rule_class_info". O campo "rule_class_key" identifica exclusivamente uma classe de regra, e o campo "rule_class_info" é uma definição de API de classe de regra no formato Stardoc.
Tags: terminal_output
--[no]proto:rule_inputs_and_outputs padrão: "true"
Se os campos "rule_input" e "rule_output" devem ser preenchidos ou não.
Tags: terminal_output
--query_file=<a string> padrão: ""
Se definido, a consulta vai ler o 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 for "true", o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de local é um caminho absoluto e não é consistente em todas 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, despeje o gráfico de ações atual do Skyframe. Observação: no momento, não é possível especificar uma meta 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 desativada, as dependências da "configuração de execução" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "configuração de execução", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante a build, em vez de uma parte do mesmo programa "target". Cquery: se desativado, filtra todos os destinos configurados que cruzam uma transição de execução do destino de nível superior que descobriu esse destino configurado. Isso significa que, se o destino de nível superior estiver na configuração de destino, somente os destinos configurados que também estiverem na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, somente os destinos configurados para execução serão retornados. Essa opção NÃO exclui toolchains resolvidas.
Tags: build_file_semantics
--universe_scope=<comma-separated list of options> padrão: ""
Um conjunto de padrões de segmentação (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pelo fechamento transitivo das metas especificadas. Essa opção é usada para os comandos "query" e "cquery". Para cquery, a entrada dessa opção são os destinos em que todas as respostas são criadas. Portanto, essa opção pode afetar 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 da expressão de consulta. Observação: para cquery, não especificar essa opção pode fazer com que o build seja interrompido se os destinos analisados da 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:
Se é necessário 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 aar permanente usando workers.
Tags: execution, experimental
--[no]experimental_remotable_source_manifests padrão: "false"
Se as ações do manifesto de origem podem ser executadas remotamente
Tags: loading_and_analysis, execution, experimental
--[no]experimental_split_coverage_postprocessing padrão: "false"
Se for "true", o Bazel vai executar o pós-processamento de cobertura para o 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 regulares. Eles não vão percorrer diretórios nem serão sensíveis a symlinks.
Tags: execution, experimental
--[no]incompatible_modify_execution_info_additive padrão: "false"
Quando ativada, a transmissão de várias flags --modify_execution_info é cumulativa. Quando desativada, apenas a última flag é considerada.
Tags: execution, affects_outputs, loading_and_analysis, incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> vários usos são acumulados
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico dela. 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=[+-]key,regex=[+-]key,...". 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 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 dessugar do Android usando workers.
Expande 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 persistentes do Android usando workers.
Expansão:--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 e multiplexadas de dex e dessugar do Android 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 persistente 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
Ativa ferramentas persistentes e multiplexadas do Android (dexing, dessugarização, processamento de recursos).
Expande 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 for "true", 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 o combinador de manifestos a ser usado para regras android_binary. Flag para ajudar na transição da combinação legada para a combinação de manifestos do Android.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--android_platforms=<a build target label> padrão: ""
Define as plataformas usadas pelas segmentações android_binary. Se várias plataformas forem especificadas, o binário será um APK gordo, 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> default: "@bazel_tools//tools/cpp:toolchain"
O rótulo do pacote crosstool a ser usado em regras do Apple e Objc e suas dependências.
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> default: "@bazel_tools//tools/test:lcov_merger"
Localização do binário usado para pós-processar relatórios de cobertura bruta. 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> default: "@bazel_tools//tools/test:coverage_report_generator"
Localização 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> default: "@bazel_tools//tools/test:coverage_support"
Localização dos arquivos de suporte necessários nas entradas de todas as ações de teste que coletam cobertura de 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 de malloc personalizada. Essa configuração substitui os atributos malloc nas regras de build.
Tags: changes_inputs, affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> vários usos são acumulados
Lista de expressões regulares separadas por vírgulas, cada uma prefixada opcionalmente por - (expressão negativa), atribuída (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino não 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 contenha "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 todas as ações do Xcode. Se a versão do Xcode tiver um rótulo hifenizado, 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 for "true", use o Xcode mais recente disponível localmente e remotamente. Se for "false" ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada com xcode-select.
Tags: loses_incremental_state, experimental
--extra_execution_platforms=<comma-separated list of options> padrão: ""
As plataformas disponíveis como plataformas de execução para realizar ações. As plataformas podem ser especificadas por segmentação exata ou como um padrão de segmentação. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores vão substituir as configurações de flag anteriores.
Tags: execution
--extra_toolchains=<comma-separated list of options> vários usos são acumulados
As regras da cadeia de ferramentas a serem consideradas durante a resolução da cadeia de ferramentas. As toolchains podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes daqueles 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 crosstool, e quase nunca é necessário substituir esse valor.
Tags: action_command_lines, affects_outputs
--host_compiler=<a string> padrão: consulte a descrição
Flag sem operação. Será removido em uma versão futura.
Tags: loading_and_analysis, execution
--host_grte_top=<a label> padrão: consulte a descrição
Se especificada, essa configuração substitui o diretório de nível superior da libc (--grte_top) para a configuração de execução.
Tags: action_command_lines, affects_outputs
--host_platform=<a build target label> default: "@bazel_tools//tools:host_platform"
O rótulo de uma regra de plataforma que descreve o sistema 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 estiver desativado, ele vai criar "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, então o primeiro é mais correto. Isso não afeta "bazel run", que sempre cria "`--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 for "true", o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas do 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 da cadeia de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativas)
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_remove_legacy_whole_archive padrão: "true"
Se for "true", o Bazel não vai vincular dependências de biblioteca como um arquivo inteiro 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 for verdadeiro, a ação de remoção para executáveis usará a flag -x, que não interrompe a resolução dinâmica de símbolos.
Tags: action_command_lines, incompatible_change
--[no]interface_shared_objects padrão: "true"
Use objetos compartilhados de interface se o conjunto de ferramentas for compatível. Todas as toolchains ELF são compatíveis com 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 do iOS a ser usada para criar aplicativos iOS. Se não for especificado, 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, 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 que sua compilação segmenta.
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 Python invocado para executar destinos 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 rótulo de um py_runtime que representa o interpretador Python invocado para executar destinos 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 desse sistema operacional. Se não for especificado, usará a versão padrão do SDK do 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, 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 fornecida 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> default: "@bazel_tools//tools/cpp:host_xcodes"
O rótulo da regra xcode_config a ser usada para selecionar a versão do Xcode na configuração de build.
Tags: loses_incremental_state, loading_and_analysis
Opções que controlam a saída do comando:
--[no]apple_generate_dsym padrão: "false"
Se é necessário gerar arquivos de símbolos de depuração (.dSYM).
Tags: affects_outputs, action_command_lines
Se for verdadeiro, vai criar florestas de symlink de runfiles para todos os destinos. Se for "false", grave-os apenas quando exigido por uma ação, teste ou comando de execução local.
Tags: affects_outputs
--[no]build_runfile_manifests padrão: "true"
Se for "true", grava manifestos de runfiles para todas as metas. Se for "false", omita-os. Os testes locais não serão executados quando for "false".
Tags: affects_outputs
--[no]build_test_dwp padrão: "false"
Se ativado, ao criar testes em C++ de forma estática e com fusã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
Padrão de --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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"
Executa ações extras para versões alternativas da 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 fissão para compilações e vinculações 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 for verdadeiro, as regras nativas vão adicionar <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 for "true", vai criar florestas de symlink 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 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 de 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 dela, e não a existência:
--action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções 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"
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso só é usado com a vinculação de dados v2. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--[no]android_databinding_use_v3_4_args padrão: "true"
Use a vinculação de dados do Android v2 com o argumento 3.4.0. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--android_dynamic_mode=<off, default or fully> padrão: "off"
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 a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo estático.
Tags: affects_outputs, loading_and_analysis
Padrão de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alphabetical"
Define a ordem dos manifestos transmitidos à ferramenta de mescla 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 dela.
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"
Crie um zip executável do Python. Ativado no Windows e desativado em outras plataformas.
Tags: affects_outputs
--catalyst_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Apenas os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não deve ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] padrão: "fastbuild"
Especifique o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--conlyopt=<a string> vários usos são acumulados
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags: action_command_lines, affects_outputs
--copt=<a string> vários usos são acumulados
Outras opções 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 informações de 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
Gere 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 despejados durante a execução.
Tags: affects_outputs
--cs_fdo_profile=<a build target label> padrão: consulte a descrição
O cs_fdo_profile que representa o perfil sensível ao contexto a ser usado para otimização.
Tags: affects_outputs
--cxxopt=<a string> vários usos são acumulados
Opção extra para transmitir ao gcc ao compilar arquivos de origem C++.
Tags: action_command_lines, affects_outputs
--define=<a 'name=value' assignment> vários usos são acumulados
Cada opção "--define" especifica uma atribuição para uma variável de build. Em caso de vários valores para uma variável, o último vence.
Tags: changes_inputs, affects_outputs
--dynamic_mode=<off, default or fully> padrão: "default"
Determina se os binários C++ serão vinculados dinamicamente. "default" significa que o Bazel vai escolher se a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo 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 a otimização do propeller 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 symlink de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags: affects_outputs
--experimental_action_listener=<a build target label> vários usos são acumulados
Obsoleto, substituído por "aspectos". Use action_listener para anexar uma extra_action a 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 a vinculação de dados do Android v2. Essa flag não faz nada.
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 rex tool to rewrite dex files
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 do compilador objc fastbuild.
Tags: action_command_lines
--[no]experimental_omitfp padrão: "false"
Se for verdadeiro, use libunwind para desenrolar 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: "off"
Qual modelo usar para onde as regras da árvore de saída gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para mais detalhes. As ações do Starlark podem ativar o mapeamento de caminhos adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> vários usos 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. Usado somente 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 for "true", um nome abreviado para a plataforma de destino será usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e está 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 um nome abreviado para a plataforma atual foi 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 inclusão de carimbos está desativada.
Tags: affects_outputs, experimental
--[no]experimental_use_llvm_covmap padrão: "false"
Se especificado, o Bazel vai gerar informações de mapa de cobertura llvm-cov em vez de gcov quando 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. Por isso, recomendamos 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
Gere binários com a instrumentação do FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão despejados durante a execução.
Tags: affects_outputs
--fdo_optimize=<a string> padrão: consulte a descrição
Use informações de perfil da FDO para otimizar a compilação. Especifique o nome de um arquivo zip que contenha 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
--features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<recurso> desativa o recurso. Recursos negativos sempre substituem os positivos. Consulte também --host_features
Tags: changes_inputs, affects_outputs
--[no]force_pic padrão: "false"
Se ativada, todas as compilações em C++ produzem código independente de posição ("-fPIC"), as vinculações preferem bibliotecas pré-criadas PIC em vez de bibliotecas não PIC, e as vinculações produzem executáveis independentes de posição ("-pie").
Tags: loading_and_analysis, affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> padrão: "opt"
Especifique o modo em que as ferramentas usadas durante a criação serão criadas. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--host_conlyopt=<a string> vários usos são acumulados
Opção extra para transmitir ao compilador C ao compilar arquivos de origem C (mas não C++) nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_copt=<a string> vários usos são acumulados
Outras opções 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 do host.
Tags: changes_inputs, affects_outputs
--host_cxxopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de execução. Especificar -<recurso> desativa o recurso. 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
--host_linkopt=<a string> vários usos são acumulados
Opção extra 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 de host. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações de execuçã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ões regulares 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 @. Somente 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 cadeia de ferramentas usada 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 for verdadeiro, o diretório genfiles será incorporado ao diretório bin.
Tags: affects_outputs, incompatible_change
--[no]instrument_test_targets padrão: "false"
Quando a cobertura está ativada, especifica se é preciso considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. 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 especificado baseado em regex são instrumentadas. As regras com o prefixo "-" são excluídas. Somente 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, usará "ios_sdk_version".
Tags: loses_incremental_state
--ios_multi_cpus=<comma-separated list of options> vários usos 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 mais detalhes. Quando ativada, 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
--linkopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para o gcc ao vincular.
Tags: action_command_lines, affects_outputs
--ltobackendopt=<a string> vários usos são acumulados
Opção adicional para transmitir à etapa de back-end do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--ltoindexopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para a etapa de indexação do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--macos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do macOS para destinos. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--memprof_profile=<a build target label> padrão: consulte a descrição
Use o perfil memprof.
Tags: affects_outputs
--[no]objc_debug_with_GLIBCXX padrão: "false"
Se definido e o modo de compilação for "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags: action_command_lines
--[no]objc_enable_binary_stripping padrão: "false"
Se é necessário realizar a remoção de símbolos e códigos mortos em binários vinculados. A remoção de binários será realizada se esta flag e --compilation_mode=opt forem especificadas.
Tags: action_command_lines
--objccopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o gcc ao compilar arquivos de origem Objective-C/C++.
Tags: action_command_lines
--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> vários usos são acumulados
Outras opções 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ões regulares 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 @. Somente 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 gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags: action_command_lines, affects_outputs
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao back-end do 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, e 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 @. Somente 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 LTO de todos os arquivos o 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",)Talvez seja necessário adicionar uma diretiva exports_files ao pacote correspondente para tornar esses arquivos visíveis ao 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 para Propeller.
Tags: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> padrão: consulte a descrição
Nome do caminho absoluto do arquivo ld_profile para builds otimizados para 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" e "//package:target --options".
Tags: action_command_lines
--[no]share_native_deps padrão: "true"
Se for "true", 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"
Adicione carimbos aos 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
Padrão de --strip=<always, sometimes or never>: "sometimes"
Especifica se os binários e as bibliotecas compartilhadas devem ser removidos (usando "-Wl,--strip-debug"). O valor padrão "sometimes" significa remover se --compilation_mode=fastbuild.
Tags: affects_outputs
--stripopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a remoção ao gerar um binário "<name>.stripped".
Tags: action_command_lines, affects_outputs
--tvos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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, usará "tvos_sdk_version".
Tags: loses_incremental_state
--visionos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para criar binários do Apple visionOS.
Tags: loses_incremental_state, loading_and_analysis
--watchos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do watchOS para simuladores e dispositivos de destino. Se não for especificado, usará "watchos_sdk_version".
Tags: loses_incremental_state
--xbinary_fdo=<a build target label> padrão: consulte a descrição
Use informações de perfil do XbinaryFDO para otimizar a compilação. Especifique o nome do perfil 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags 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 dos destinos que estão sendo criados. 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 nas dependências de destino serão rebaixados para avisos.
Tags: build_file_semantics
--[no]desugar_for_android padrão: "true"
Se o bytecode Java 8 deve ser simplificado antes da conversão para DEX.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--[no]desugar_java8_libs padrão: "false"
Se as bibliotecas Java 8 compatíveis devem 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"
Se é necessário verificar novamente a dessugarização correta 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
No-op, 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 opção 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 for 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 testonly para destinos de pré-requisito que são arquivos de saída pesquisando 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 a implementações de cadeia de ferramentas.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_disable_native_android_rules padrão: "false"
Se ativada, 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"
No-op. Mantido aqui para compatibilidade com versões anteriores.
Tags: eagerness_to_exit, incompatible_change
--[no]incompatible_python_disable_py2 padrão: "true"
Se for verdadeiro, usar as configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15684.
Tags: loading_and_analysis, incompatible_change
--[no]one_version_enforcement_on_java_tests padrão: "true"
Quando ativada e com experimental_one_version_enforcement definido como um valor diferente de NONE, impõe uma versão em destinos java_test. Essa flag pode ser desativada para melhorar a performance do teste incremental, mas isso pode fazer com que possíveis violações de uma versão sejam perdidas.
Tags: loading_and_analysis
--python_native_rules_allowlist=<a build target label> padrão: consulte a descrição
Uma lista de permissões (destino 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 cruzam 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 OFF, 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: "off"
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente como exportados todos os destinos usados em "import public".
Tags: build_file_semantics, eagerness_to_exit, incompatible_change
--[no]strict_system_includes padrão: "false"
Se for "true", os cabeçalhos encontrados por caminhos de inclusão do sistema (-isystem) também precisarão ser declarados.
Tags: loading_and_analysis, eagerness_to_exit
--target_environment=<a build target label> vários usos são acumulados
Declara o ambiente de destino desta build. Precisa ser uma referência de rótulo a 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 incluirão 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, será usado o perfil de provisionamento. Pode ser a preferência de identidade do keychain do certificado ou (substring) do nome comum do certificado, conforme a página de manual do 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"
Sem operação, será removido em breve.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes padrão: "false"
Se for "true", não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags: build_file_semantics, incompatible_change
Se for verdadeiro, defina o valor padrão como verdadeiro para 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 devem 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 regem o comportamento do ambiente de teste ou do executor de testes:
--[no]allow_analysis_failures padrão: "false"
Se for "true", uma falha na análise de um destino de regra vai resultar na propagação 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
Padrão de --analysis_testing_deps_limit=<an integer>: "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 for "true", as falhas na ação dex2oat vão interromper o build em vez de executar dex2oat durante o tempo de execução do teste.
Tags: loading_and_analysis, experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> vários usos são acumulados
Substitua a quantidade padrão de recursos 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írgulas 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"
Ative 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 é ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags: test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> vários usos são acumulados
Especifica o número de vezes que cada teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado falho. 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 transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
--test_env=<a 'name=value' assignment with an optional value part> vários usos 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, caso em que o valor será lido do ambiente do cliente 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"
Substitui 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 uma das formas, um valor de -1 informa ao Blaze para usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs padrão: "false"
Se for "true", 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 ProGuard ProgramJar 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 em C++ serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_inmemory_jdeps_files padrão: "true"
Se ativados, os arquivos de dependência (.jdeps) gerados de compilações Java serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_retain_test_configuration_across_testonly padrão: "false"
Quando ativada, a flag --trim_test_configuration não vai remover a configuração de teste para regras marcadas como testonly=1. Isso reduz problemas de conflito de ações quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for "false".
Tags: loading_and_analysis, loses_incremental_state, experimental
--[no]experimental_starlark_cc_import padrão: "false"
Se ativada, a versão Starlark de cc_import poderá ser usada.
Tags: loading_and_analysis, experimental
--[no]experimental_unsupported_and_brittle_include_scanning padrão: "false"
Se as entradas devem ser restritas à compilação C/C++ analisando linhas #include de 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. Em particular, 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 flag que forem enviados serão encerrados.
Tags: loading_and_analysis, execution, changes_inputs, experimental
--[no]incremental_dexing padrão: "true"
Faz a maior parte do trabalho de dexagem 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 reduzir o conjunto de entradas transmitidas para 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çalho estiver ativado para a cadeia de ferramentas).
Tags: execution
--[no]trim_test_configuration padrão: "true"
Quando ativadas, as opções relacionadas a testes 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 a testes 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 detalhe, o formato ou o local do registro em log:
Padrão de --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
Imprime informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação a tipos de cadeia de ferramentas e destinos específicos para ver qual depurar. É possível separar várias expressões regulares com vírgulas, e cada uma delas é verificada separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de toolchain.
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:
--flag_alias=<a 'name=value' flag alias> vários usos 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 arquivos de execução de destinos Python. Precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (o 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 for 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 Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o symlink 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 recomendamos ativar `--incompatible_py3_is_default`. Tags do
: affects_outputs, incompatible_change
--[no]incompatible_py3_is_default padrão: "true"
Se for verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão usar PY3 em vez de PY2 por padrão. Se você definir essa flag, também recomendamos definir `--incompatible_py2_outputs_are_suffixed`. Tags do
: loading_and_analysis, affects_outputs, incompatible_change
--[no]incompatible_use_python_toolchains padrão: "true"
Se definido como "true", as regras executáveis do Python nativo vão usar o ambiente de execução do Python especificado pela cadeia 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 da versão principal do Python, `PY2` ou `PY3`. Isso é substituído por destinos `py_binary` e `py_test`, mesmo que eles não especifiquem uma versão explicitamente. Portanto, geralmente não há muito motivo para fornecer essa flag.
Tags: loading_and_analysis, affects_outputs
Opções diversas, não categorizadas de outra forma.:
--[no]cache_test_results [-t] padrão: "auto"
Se definido como "auto", o Bazel vai executar um teste novamente se e somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste forem solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "yes", o Bazel armazena em cache todos os resultados de testes, 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 for "true", o Blaze vai cancelar os testes em execução simultânea 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 for "true", o Bazel vai buscar o diretório inteiro de dados de cobertura 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 for 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"
Se é necessário gerar o mapa de cabeçalho J2ObjC em paralelo à transcompilação do J2ObjC.
Tags: experimental
--[no]experimental_j2objc_shorter_header_path padrão: "false"
Se a geração deve usar um caminho de cabeçalho mais curto ("_ios" em vez de "_j2objc").
Tags: affects_outputs, experimental
--experimental_java_classpath=<off, javabuilder or bazel> padrão: "javabuilder"
Ativa caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java padrão: "false"
No-op, mantido apenas para compatibilidade com versões anteriores
Tags: affects_outputs, experimental
--[no]experimental_run_android_lint_on_java_rules padrão: "false"
Se as fontes java_* devem 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 obter acidentalmente das dependências do TestRunner. No momento, só funciona para bazel.
--host_java_launcher=<a build target label> padrão: consulte a descrição
O inicializador Java usado por ferramentas executadas durante um build.
--host_javacopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o javac ao criar ferramentas executadas durante um build.
--host_jvmopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a VM Java ao criar ferramentas 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 for verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de testes não indicar que oferece suporte à fragmentação ao tocar no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for "false", um executor de testes que não oferece suporte ao sharding vai fazer com que todos os testes sejam executados em cada fragmento.
Tags: incompatible_change
--[no]incompatible_exclusive_test_sandboxed padrão: "true"
Se for "true", os testes exclusivos serão executados com a estratégia em sandbox. Adicione a tag "local" para forçar uma execução de teste exclusiva no local
Tags: incompatible_change
--[no]incompatible_strict_action_env padrão: "false"
Se for "true", o Bazel usará um ambiente com um valor estático para PATH e não vai herdar LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente, mas observe que 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
Outras opções a serem transmitidas para a 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 -test_output=streamed.
Expansão:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps padrão: "true"
Gere informações de dependência (por enquanto, classpath de tempo de compilação) por destino Java.
--[no]java_header_compilation padrão: "true"
Compile ijars diretamente da origem.
--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 inicializador 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.
Padrão de --java_runtime_version=<a string>: "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.
--jvmopt=<a string> vários usos 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 dexing sem sharding.
--plugin=<a build target label> vários usos são acumulados
Plug-ins a serem usados no build. No momento, funciona com java_plugin.
--proguard_top=<a build target label> padrão: consulte a descrição
Especifica qual versão do ProGuard usar para remoção de código ao criar um binário Java.
--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"
O rótulo do proto-compilador.
Tags: affects_outputs, loading_and_analysis
--[no]proto_profile padrão: "true"
Se profile_path deve ser transmitido ao 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 (o padrão), vai inferir o caminho de --fdo_optimize.
Tags: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> default: "@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> default: "@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> default: "@bazel_tools//tools/proto:javalite_toolchain"
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags: affects_outputs, loading_and_analysis
--protocopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador protobuf.
Tags: affects_outputs
--[no]runs_per_test_detects_flakes padrão: "false"
Se for "true", qualquer fragmento em que pelo menos uma execução/tentativa seja aprovada e pelo menos uma execução/tentativa falhe vai receber 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 não estiver definido, 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 dos dois estiver definido, o Bazel usará um caminho padrão codificado, 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). Usar um shell incompatível com bash pode causar falhas de build ou de tempo de execução dos binários gerados.
Tags: loading_and_analysis
--test_arg=<a string> vários usos são acumulados
Especifica outras opções e argumentos que devem ser transmitidos ao 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 a ser encaminhado para a estrutura de teste. Usado para limitar os testes executados. Isso não afeta quais destinos são criados.
--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 testes. O executor de testes 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 fragmentação de testes: "explicit" para usar a fragmentação somente se o atributo "shard_count" BUILD estiver presente. "disabled" para nunca usar o sharding de teste. "forced=k" para forçar "k" fragmentos para teste, independente do atributo "shard_count" BUILD.
--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 resulta 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 todas as metas estiverem atualizadas, a build será concluída com sucesso. Se alguma etapa precisar ser executada, um erro será informado e a build vai falhar.
Tags: execution
Padrão de --dynamic_local_execution_delay=<an integer>: "1000"
Quantos milissegundos a execução local deve ser atrasada se a execução remota foi mais rápida durante uma build pelo menos uma vez?
Tags: execution, host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> vários usos são acumulados
As estratégias locais, em ordem, a serem usadas para o mnemônico especificado. 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 todas as outras usando a estratégia em sandbox. Se nenhum mnemônico for fornecido, a lista de estratégias será usada como substituta 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. Usa [mnemonic=]local_strategy[,local_strategy,...]
Tags: execution, host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> vários usos são acumulados
As estratégias remotas, em ordem, a serem usadas para o mnemônico especificado. A primeira estratégia aplicável é usada. Se nenhum mnemônico for fornecido, a lista de estratégias será usada como substituta para todos os mnemônicos. A lista de substituição padrão é "remota", então essa flag geralmente não precisa ser definida explicitamente. Usa [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 em si ainda não tem um atributo container-image nas remote_execution_properties na descrição da plataforma. O valor dessa flag é transmitido literalmente para "docker run", então ele é compatível com a mesma sintaxe e os mesmos 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 sua build / testes dependem de o usuário ter um nome e um diretório inicial dentro do contêiner. Ele fica ativado por padrão, mas pode ser desativado caso a personalização automática de imagens não funcione para você ou se você não precisar dela.
Tags: execution
--[no]experimental_dynamic_exclude_tools padrão: "true"
Quando definido, os destinos criados "para a ferramenta" não estão sujeitos à execução dinâmica. É extremamente 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 na execução dinâmica serão programadas simultaneamente. Ele se baseia no número de CPUs que o Blaze considera disponíveis, o que pode ser controlado com a flag --local_cpu_resources. Se essa flag for 0, todas as ações serão programadas localmente imediatamente. Se for > 0, a quantidade de ações agendadas 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 reduz a carga na máquina local no caso de uma build limpa, 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 >0, o tempo que uma ação executada dinamicamente precisa ser executada apenas remotamente antes de priorizarmos a execução local para evitar tempos limite 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 sandbox baseado no 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 caixas de areia 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 real. Dependendo do build, essa flag pode usar uma quantidade significativa de memória extra.
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 for 0, exclua as árvores de sandbox assim que uma ação for concluída (atrasando a 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 de tamanho 1 quando o build estiver em execução e aumente para o tamanho especificado por essa flag quando o servidor estiver inativo.
Tags: host_machine_resource_optimizations, execution
--experimental_sandbox_enforce_resources_regexp=<a valid Java regular expression> padrão: ""
Se for verdadeiro, as ações cujo mnemônico corresponder à 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 for compatível. 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
--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"> vários usos são acumulados
Se for > 0, cada sandbox do Linux será limitado à quantidade especificada para o recurso indicado. 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 ativada, 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 com o registro de teste. Caso contrário, o Bazel vai gerar 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 inativos 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 o que é fornecido com sandbox_add_mount_pair. Os arquivos de entrada serão vinculados fisicamente ao sandbox, em vez de serem vinculados simbolicamente a partir dele. 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", também use 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 compatível do sandboxfs. Se for "auto", o binário pode estar faltando 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, só permita o uso de workers persistentes com o mnemônico de chave de worker especificado.
Tags: execution, host_machine_resource_optimizations
--[no]experimental_worker_cancellation padrão: "false"
Se ativado, o Bazel poderá enviar solicitações de cancelamento para workers que oferecem suporte a elas.
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 deles exceder o limite. Se não for usado com a execução dinâmica e `--experimental_dynamic_ignore_local_signals=9`, isso pode falhar na sua build.
Tags: execution, host_machine_resource_optimizations
Padrão de --experimental_worker_metrics_poll_interval=<An immutable length of time.>: "5s"
O intervalo entre a coleta de métricas do worker e a possível tentativa de remoção. Não pode ser efetivamente menor que 1 segundo por motivos de desempenho.
Tags: execution, host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing padrão: "false"
Se ativados, os trabalhadores de multiplex com um requisito de execução "supports-multiplex-sandboxing" serão executados em um ambiente isolado, usando um diretório de sandbox separado por solicitação de trabalho. Os workers multiplexados com o requisito de execução são sempre isolados em sandbox quando executados na estratégia de execução dinâmica, independente dessa flag.
Tags: execution
--[no]experimental_worker_sandbox_hardening padrão: "false"
Se ativado, os workers serão executados em um sandbox reforçado, se a implementação permitir. Se a proteção estiver ativada, os diretórios tmp serão distintos para diferentes workers.
Tags: execution
--experimental_worker_sandbox_inmemory_tracking=<a string> vários usos são acumulados
Um mnemônico de chave de worker para o qual o conteúdo do diretório sandbox é rastreado na memória. Isso pode melhorar o desempenho do build ao custo de uso adicional de memória. Isso afeta apenas os workers em sandbox. Pode ser especificado várias vezes para diferentes mnemônicos.
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.
Tags: execution
--genrule_strategy=<comma-separated list of options> padrão: ""
Especifique como executar 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 genrules.
Tags: execution
--[no]incompatible_sandbox_hermetic_tmp padrão: "true"
Se definido como "true", cada sandbox do Linux terá seu 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 /tmp do host em todas as caixas de isolamento.
Tags: execution
--[no]incompatible_use_new_cgroup_implementation padrão: "false"
Se for verdadeiro, use a nova implementação para cgroups. A implementação antiga só é compatível com o 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 saber no Blaze se o programador de geraçã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. Usa 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 o destino com falha e aqueles que dependem dele não possam ser analisados, outros pré-requisitos desses destinos 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"), opcionalmente seguida 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 worker em sandbox poderão 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 muito o desempenho quando seu build / testes tiverem muitos arquivos de entrada. Observação: é necessário ter RAM e espaço livre suficientes no tmpfs para armazenar arquivos intermediários e de saída gerados pela execução de ações.
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 a definição do ID do grupo do processo como "tty" dentro do sandbox para que os pseudoterminais funcionem. Se isso estiver causando problemas, a flag poderá ser desativada para permitir o uso de outros grupos.
Tags: execution
--sandbox_tmpfs_path=<an absolute path> vários usos são acumulados
Para ações em sandbox, monte um diretório vazio e gravável nesse caminho absoluto (se compatível com a implementação de sandbox; caso contrário, será ignorado).
Tags: host_machine_resource_optimizations, execution
--[no]skip_incompatible_explicit_targets padrão: "false"
Ignora destinos incompatíveis que estão explicitamente listados na linha de comando. Por padrão, a criação desses 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: ""
Especifica 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
--strategy=<a '[name=]value1[,..,valueN]' assignment> vários usos são acumulados
Especifique como distribuir a compilação de outras ações de geraçã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 usada com o mnemônico Genrule). Consulte https://blog.bazel.build/2019/06/19/list-strategy.html para mais detalhes.
Tags: execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> vários usos são acumulados
Substitui qual estratégia de geração deve ser usada para executar ações de geração com descrições que correspondem a um determinado regex_filter. Consulte --per_file_copt para mais detalhes 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 inverter a ordem vai executar com 'sandboxed'.
Tags: execution
--worker_extra_flag=<a 'name=value' assignment> vários usos são acumulados
Flags de comando extras que serão transmitidas aos processos de worker além de --persistent_worker, com chave por mnemônico (por exemplo, --worker_extra_flag=Javac=--debug.
Tags: execution, host_machine_resource_optimizations
--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"> vários usos 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 dar 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 o especificado por essa flag. Usa 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
--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"> vários usos são acumulados
Quantos WorkRequests um processo de worker multiplex pode receber em paralelo se você usar a estratégia "worker" com --worker_multiplex. Pode ser especificado como [name=value] para dar 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 o especificado por essa flag. Usa 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 ativado, os workers vão usar multiplexação se houver suporte para isso.
Tags: execution, host_machine_resource_optimizations
--[no]worker_quit_after_build padrão: "false"
Se ativado, todos os workers serão encerrados após a conclusão de um build.
Tags: execution, host_machine_resource_optimizations
--[no]worker_sandboxing padrão: "false"
Se ativados, os workers singleplex serão executados em um ambiente isolado. Os workers singleplex sempre são isolados em sandbox quando executados com a estratégia de execução dinâmica, independente dessa flag.
Tags: execution
--[no]worker_verbose padrão: "false"
Se ativada, imprime mensagens detalhadas quando os trabalhadores são iniciados, desligados 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 a build pare antes de executar as ações de build, retornando zero se as fases de carregamento e análise de pacotes forem concluídas com êxito. Esse modo é útil para testar essas fases.
Tags: execution, affects_outputs
--[no]experimental_use_validation_aspect padrão: "false"
Se as ações de validação devem ser executadas usando o aspecto (para paralelismo com testes).
Tags: execution, affects_outputs
--output_groups=<comma-separated list of options> vários usos são acumulados
Uma lista de nomes de grupos de saída separados por vírgulas, cada um deles prefixado opcionalmente por um + ou um -. Um grupo prefixado por + é adicionado ao conjunto padrão de grupos de saída, enquanto um grupo prefixado por - é removido do conjunto padrão. Se pelo menos um grupo não tiver 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"
Se as ações de validação devem ser 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 dela, e não a existência:
--aspects=<comma-separated list of options> vários usos 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 obrigatórios usando required_aspect_providers, some_aspect será executado após cada aspecto mencionado antes dele na lista de aspectos cujos provedores anunciados atendem aos provedores de aspecto obrigatórios de some_aspect. Além disso, "some_aspect" será executado depois de todos os aspectos obrigatórios especificados pelo atributo "requires". Assim, "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
Essa flag controla como os symlinks de conveniência (os symlinks 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" fosse transmitido, mas não executa nenhuma operação do sistema de arquivos (útil para ferramentas). Somente os symlinks cujos nomes são gerados pelo valor atual de --symlink_prefix podem ser afetados. Se o prefixo mudar, os symlinks preexistentes não serão alterados.
Tags: affects_outputs
Essa flag controla se vamos postar o build eventConvenienceSymlinksIdentified no BuildEventProtocol. Se o valor for "true", o BuildEventProtocol terá uma entrada para "convenienceSymlinksIdentified", listando todos os symlinks de conveniência criados no seu espaço de trabalho. Se for "false", a entrada "convenienceSymlinksIdentified" em "BuildEventProtocol" vai ficar 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".
Expande 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.
Expande para:
  --remote_download_outputs=minimal

Tags: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> padrão: "toplevel"
Se definido como "minimal", não baixa nenhuma saída de build remoto para a máquina local, exceto as necessárias para ações locais. Se definido como "toplevel", se comporta como "minimal", exceto que também faz o download das saídas de destinos de nível superior para a máquina local. As duas opções podem reduzir significativamente os tempos de build se a largura de banda da rede for um gargalo.
Tags: affects_outputs
Em vez de baixar 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 são expandidos para o hash do objeto e o tamanho em bytes, respectivamente. Esses links simbólicos podem, por exemplo, apontar para um sistema de arquivos FUSE que carrega objetos do CAS sob demanda.
Tags: affects_outputs
--remote_download_toplevel
Faz o download apenas das saídas remotas de destinos de nível superior para a máquina local. Essa flag é um alias de --remote_download_outputs=toplevel.
Expande para:
  --remote_download_outputs=toplevel

Tags: affects_outputs
O prefixo que é adicionado a qualquer um dos symlinks de conveniência criados após um build. Se omitido, o valor padrão será o nome da ferramenta de build seguido por 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags etc.):
--[no]experimental_docker_privileged padrão: "false"
Se ativado, o Bazel vai transmitir a flag "--privileged" para "docker run" ao executar ações. Isso pode ser exigido pelo seu build, mas também pode resultar em hermeticidade reduzida.
Tags: execution
No-op
Tags: host_machine_resource_optimizations, execution
--[no]incompatible_legacy_local_fallback padrão: "false"
Se definido como "true", ativa o fallback implícito legado da estratégia em sandbox para a local. Essa flag vai passar a ser "false" por padrão e, depois, não vai fazer nada. Use --strategy, --spawn_strategy ou --dynamic_local_strategy para configurar substituições.
Tags: execution, incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair> vários usos são acumulados
Adicione outro par de caminhos para montar na sandbox.
Tags: execution
--sandbox_block_path=<a string> vários usos são acumulados
Para ações em sandbox, não permita o acesso a esse 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 sandbox.
Tags: execution
--[no]sandbox_fake_username padrão: "false"
Mude o nome de usuário atual para "nobody" em ações em sandbox.
Tags: execution
--sandbox_writable_path=<a string> vários usos são acumulados
Para ações em sandbox, torne um diretório gravável no sandbox (se compatível com a implementação do sandbox, caso contrário, 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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
Tags: loading_and_analysis
Opções que regem o comportamento do ambiente de teste ou do executor de testes:
--[no]check_tests_up_to_date padrão: "false"
Não execute testes, apenas verifique se eles estão atualizados. Se todos os resultados estiverem atualizados, o teste será concluído. Se algum teste precisar ser criado ou executado, um erro será informado e o teste vai falhar. Essa opção implica o comportamento --check_up_to_date.
Tags: execution
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> vários usos são acumulados
Cada teste será repetido até o número especificado de vezes em caso de falha. Os testes que exigiram mais de uma tentativa para serem aprovados são marcados como "IRREGULAR" 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 "default", será feita apenas uma tentativa de teste 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ões regulares de inclusão e exclusão. Consulte também --runs_per_test. Exemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 remove a irregularidade de todos os testes em //foo/, exceto os em foo/bar, três vezes. Essa opção pode ser transmitida várias vezes. O argumento transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o comportamento será como o "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 local a serem executados simultaneamente. Usa 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 a serem executados simultaneamente. Definir um valor maior que o de --jobs não tem efeito.
Tags: execution
--[no]test_keep_going padrão: "true"
Quando desativado, qualquer teste reprovado interrompe todo o build. 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 do "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 deles, em vez de recalcular os resumos do disco sempre que eles forem necessários. Definir como 0 garante a correção, porque nem todas as mudanças de arquivo podem ser observadas nos metadados do arquivo. 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 o agendamento experimental de execução local com base na carga da CPU, não na estimativa de ações individuais. O agendamento experimental mostrou o grande benefício em builds locais grandes em máquinas potentes com um grande número de núcleos. 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
Usa uma lista de números de indicadores do SO. Se uma ramificação local da 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 for verdadeiro, ative 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 do Skyfocus. Especifique como caminhos separados por vírgulas relativos à raiz do espaço de trabalho. Essa é uma flag com estado. A definição de um conjunto de trabalho o mantém para invocações subsequentes até que ele seja redefinido 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 gastar em ações de build executadas localmente. Aceita um número inteiro ou "HOST_CPUS", opcionalmente seguido 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
--local_extra_resources=<a named float, 'name=value'> vários usos são acumulados
Defina o número de recursos extras disponíveis para o Bazel. Recebe um par string-float. Pode ser usado várias vezes para especificar vários tipos de recursos extras. O Bazel limita as ações em execução simultânea 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>". A CPU, a RAM e os recursos disponíveis não podem ser definidos 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 gastar em ações de build executadas localmente. Aceita um número inteiro ou "HOST_RAM", opcionalmente seguido 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
--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"> vários usos são acumulados
Defina o número de recursos disponíveis para o Bazel. Recebe uma atribuição a um ponto flutuante ou HOST_RAM/HOST_CPUS, opcionalmente seguida 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 limita as ações em execução simultânea com base nos recursos disponíveis e nos recursos necessários. Os testes podem declarar a quantidade de recursos necessários 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 do registro em log:
--build_event_upload_max_retries=<an integer> padrão: "4"
O número máximo de vezes que o Bazel deve tentar fazer 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"
Se os eventos TargetSummary devem ser publicados.
--[no]experimental_build_event_expand_filesets padrão: "false"
Se for verdadeiro, expanda os conjuntos de arquivos no BEP ao apresentar arquivos de saída.
Tags: affects_outputs
Se for "true", vai resolver totalmente os links simbólicos relativos do conjunto de arquivos no BEP ao apresentar arquivos de saída. Exige --experimental_build_event_expand_filesets.
Tags: affects_outputs
--experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both> vários usos são acumulados
Especifique como os arquivos de um grupo de saída serão representados em eventos BEP TargetComplete/AspectComplete. Os valores são uma atribuição de um nome de grupo de saída a um de "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 aparecer será usado. O valor padrão define o modo para artefatos de cobertura como "BOTH": --experimental_build_event_output_group_mode=baseline.lcov=both
Tags: affects_outputs
Padrão de --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
Delay inicial e mínimo para novas 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 dos artefatos referenciados no protocolo de eventos de build.
Tags: affects_outputs
--[no]experimental_docker_verbose padrão: "false"
Se ativado, o Bazel vai imprimir mensagens mais detalhadas sobre a estratégia de sandbox do Docker.
Tags: execution
--[no]experimental_materialize_param_files_directly padrão: "false"
Se você estiver materializando arquivos de parâmetros, 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 Starlark com as informações resolvidas de todas as regras de repositório Starlark executadas.
Tags: affects_outputs
--[no]experimental_run_bep_event_include_residue padrão: "false"
Indica se o resíduo da linha de comando deve ser incluído em eventos de build de execução que podem conter o resíduo. Por padrão, o resíduo não é incluído em eventos de build de comandos de execução que podem conter o resíduo.
Tags: affects_outputs
--experimental_skyfocus_dump_keys=<none, count or verbose> padrão: "none"
Para depuração do Skyfocus. Despeja as SkyKeys em foco (raízes, folhas, dependências em foco, dependências inversas em foco).
Tags: terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats padrão: "false"
Para depuração do Skyfocus. Se ativado, acione a coleta de lixo manual antes/depois de focar para informar as reduções de tamanho do heap. Isso vai aumentar a latência do Skyfocus.
Tags: terminal_output
--experimental_skyfocus_handling_strategy=<strict or warn> padrão: "strict"
Estratégias para o Skyfocus lidar com mudanças fora do conjunto de trabalho.
Tags: eagerness_to_exit
--[no]experimental_stream_log_file_uploads padrão: "false"
Faça streaming dos uploads de arquivos de registro diretamente para o armazenamento remoto em vez de gravá-los 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 imprima um aviso quando a execução em sandbox não for compatível com este sistema.
Tags: terminal_output
--[no]legacy_important_outputs padrão: "false"
Use isso para suprimir a geração do campo legado "important_outputs" no evento "TargetComplete". Os "important_outputs" são necessários para a integração do Bazel com o ResultStore/BTX.
Tags: affects_outputs
--[no]materialize_param_files padrão: "false"
Grava arquivos de parâmetros intermediários na árvore de saída, mesmo ao usar a execução de ações remotas. Útil ao depurar ações. Isso está implícito em --subcommands e --verbose_failures.
Tags: execution
Padrão de --max_config_changes_to_show=<an integer>: "3"
Ao descartar o cache de análise devido a uma mudança nas opções de build, mostra até o número especificado de nomes de opções alterados. Se o número fornecido 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 do registro por teste que pode ser emitido quando --test_output é "errors" ou "all". Útil para evitar sobrecarregar a saída com resultados de teste excessivamente ruidosos. O cabeçalho do teste está incluído no tamanho do registro. Valores negativos significam que não há 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
Mostra apenas avisos e saídas de ações 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 a aguardar entre relatórios sobre jobs 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, em seguida, o progresso será informado uma vez por minuto. Quando --curses está ativado, o progresso é informado a cada segundo.
Tags: affects_outputs
Padrão de --remote_print_execution_messages=<failure, success or all>: "failure"
Escolha quando imprimir mensagens de execução remota. Os valores válidos são "failure" (para imprimir apenas em caso de falha), "success" (para imprimir apenas em caso de sucesso) e "all" (para imprimir sempre).
Tags: terminal_output
--[no]sandbox_debug padrão: "false"
Ativa recursos de depuração para o recurso de isolamento em sandbox. Isso inclui duas coisas: primeiro, o conteúdo da raiz da sandbox não é alterado após um build; e segundo, imprime informações extras de depuração na execução. Isso pode ajudar os desenvolvedores de regras do Bazel ou do Starlark a depurar falhas devido à falta de arquivos de entrada etc.
Tags: terminal_output
Padrão de --show_result=<an integer>: "1"
Mostra os resultados do build. Para cada destino, informe se ele foi atualizado ou não e, em caso afirmativo, uma lista dos arquivos de saída criados. Os arquivos impressos são strings convenientes para copiar e colar no shell e executá-los. Essa opção exige um argumento inteiro, que é o número limite de destinos acima do qual as informações de resultado não são impressas. Assim, zero suprime a mensagem, e MAX_INT faz com que o resultado seja impresso sempre. O padrão é um. Se nada foi criado para um destino, os resultados 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 também imprimir os registros de testes com falha, "all" para imprimir registros de todos os testes e "streamed" para gerar registros de todos os testes em tempo real. Isso força a execução dos testes localmente, um de cada vez, independente do valor de --test_strategy.
Tags: test_runner, terminal_output, execution
Padrão de --test_summary=<short, terse, detailed, none or testcase>: "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 casos de teste com falha, "testcase" para imprimir o resumo na resolução do caso de teste, não imprimir informações detalhadas sobre casos de teste com falha e "none" para omitir o resumo.
Tags: terminal_output
--[no]verbose_explanations padrão: "false"
Aumenta o detalhamento das explicações emitidas se --explain estiver ativado. 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:
--aspects_parameters=<a 'name=value' assignment> vários usos são acumulados
Especifica os valores dos parâmetros de aspectos da linha de comando. Cada valor de parâmetro é especificado via <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 de na linha de comando. É um erro especificar um arquivo aqui e 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 "failure". Em um valor inválido para a opção, o comportamento é o mesmo que se a opção não estivesse definida.
Tags: execution
--[no]experimental_guard_against_concurrent_changes padrão: "false"
Desative essa opção para desabilitar a verificação do ctime dos arquivos de entrada de uma ação antes de fazer upload para um cache remoto. Em alguns casos, o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
Padrão de --experimental_remote_cache_compression_threshold=<an integer>: "100"
O tamanho mínimo do blob necessário para compactar/descompactar com zstd. Não tem efeito, a menos que --remote_cache_compression esteja definido.
Padrão de --experimental_remote_cache_eviction_retries=<an integer>: "5"
O número máximo de tentativas de repetição se a build encontrar um erro transitório de cache remoto que, de outra forma, causaria falha na build. Isso se aplica, por exemplo, quando artefatos são removidos do cache remoto ou em determinadas condições de falha do cache. Um valor diferente de zero vai definir 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 um ID de invocação e fornecê-lo 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 "true", o Bazel vai estender o lease 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`.
Padrão de --experimental_remote_cache_ttl=<An immutable length of time.>: "3h"
O TTL mínimo garantido de blobs no cache remoto depois que os resumos são referenciados recentemente, por exemplo, por um ActionResult ou FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs. Por exemplo, ele 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 quando 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 "true", descarta as cópias na memória da árvore de Merkle da raiz de entrada e os mapeamentos de entrada associados durante as chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso da memória, mas exige que o Bazel os recalcule em caso de falhas e novas tentativas de cache remoto.
--experimental_remote_downloader=<a string> padrão: consulte a descrição
Um URI de endpoint da API Remote Asset, a ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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"
Se é necessário voltar ao downloader local se o downloader remoto falhar.
--[no]experimental_remote_downloader_propagate_credentials padrão: "false"
Se as credenciais do netrc e do auxiliar de credenciais serão propagadas para o servidor de 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 no campo `uris` do FetchBlobRequest. Os cabeçalhos específicos do URL têm precedência sobre os globais.
--[no]experimental_remote_execution_keepalive padrão: "false"
Indica se o keepalive será usado para chamadas de execução remota.
Padrão de --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "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 como 0 significa que não há limitação.
Tags: execution
Padrão de --experimental_remote_failure_window_interval=<An immutable length of time.>: "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 é calculada como toda a duração da execução.As seguintes unidades 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 "true", o Bazel vai marcar as entradas como entradas de ferramentas para o executor remoto. Isso pode ser usado para implementar trabalhadores persistentes remotos.
--[no]experimental_remote_merkle_tree_cache padrão: "false"
Se definido como "true", os cálculos da árvore de Merkle serão memorizados para melhorar a velocidade de verificação de acertos do cache remoto. A pegada de memória do cache é controlada por --experimental_remote_merkle_tree_cache_size.
Padrão de --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
O número de árvores de Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrência em cache remoto. Embora o cache seja reduzido automaticamente de acordo com o processamento de referências leves do Java, erros de falta de memória podem ocorrer se o valor estiver muito alto. 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 remota. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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 "true", força o cache de todas as ações que podem ser executadas remotamente ou falha na build. Isso é útil para resolver problemas de não determinismo, porque permite verificar se as ações que devem ser armazenadas em cache são realmente armazenadas sem inserir novos resultados no cache.
--experimental_remote_scrubbing_config=<Converts to a Scrubber> padrão: consulte a descrição
Ativa a limpeza remota de chaves de cache com o arquivo de configuração fornecido, que precisa ser um buffer de protocolo em 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 segmentando a mesma plataforma. Ele precisa ser usado com muito cuidado, já que 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/de disco é calculada para recuperar ou armazenar um resultado de ação. As ações de limpeza não são compatí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, provavelmente você vai querer definir um --host_platform personalizado junto com --experimental_platform_in_output_dir (para normalizar prefixos de saída) e --incompatible_strict_action_env (para normalizar variáveis de ambiente).
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs padrão: "true"
Se definido como "true", o Bazel usará o novo código de saída 39 em vez de 34 se erros de cache remoto, incluindo remoções de cache, causarem falha na build.
Tags: incompatible_change
--[no]remote_accept_cached padrão: "true"
Se os resultados de ações armazenados em cache remotamente devem ser aceitos.
--remote_build_event_upload=<all or minimal> padrão: "minimal"
Se definido como "all", todas as saídas locais referenciadas pelo BEP serão enviadas por upload para o cache remoto. Se definido como "minimal", as saídas locais referenciadas pelo BEP não serão enviadas para o cache remoto, exceto arquivos importantes para os consumidores do BEP (por exemplo, registros de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o URI dos arquivos, mesmo que eles estejam ausentes do 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 serem usados em URIs bytestream:// gravados em fluxos 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 cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (sockets UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. 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 for "true", 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 ainda podem bloquear mesmo quando essa flag está definida.
--[no]remote_cache_compression padrão: "false"
Se ativado, compacta/descompacta blobs de cache com zstd quando o tamanho deles for pelo menos --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações de cache: --remote_cache_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_default_exec_properties=<a 'name=value' assignment> vários usos são acumulados
Define as propriedades de execução padrão a 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: ""
Define as propriedades de plataforma padrão a serem definidas para a API Remote Execution, caso a plataforma de execução ainda não tenha 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.
--remote_download_regex=<a valid Java regular expression> vários usos são acumulados
Força o download de saídas de build remoto cujo caminho corresponda a esse padrão, independente de --remote_download_outputs. É possível especificar vários padrões repetindo essa flag.
Tags: affects_outputs
--remote_downloader_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações do downloader remoto: --remote_downloader_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para o mesmo nome serão convertidos em uma lista separada por vírgulas.
--remote_exec_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações de execução: --remote_exec_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para 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 UNIX locais). Se nenhum esquema for fornecido, o Bazel vai usar grpcs como padrão. Especifique o esquema grpc:// ou unix: para desativar o TLS.
--remote_grpc_log=<a path> padrão: consulte a descrição
Se especificado, é o caminho para um arquivo em que os detalhes relacionados à chamada gRPC serão registrados. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados. Cada mensagem tem como prefixo uma varint que indica o tamanho da seguinte mensagem protobuf serializada, conforme realizado pelo método LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment> vários usos são acumulados
Especifique um cabeçalho que será incluído nas solicitações: --remote_header=Name=Value. É possível transmitir vários cabeçalhos especificando a flag várias vezes. Vários valores para 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"
Se é necessário voltar para a estratégia de execução local independente 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 mais detalhes.
Padrão de --remote_max_connections=<an integer>: "100"
Limita o número máximo de conexões simultâneas com o cache/executor remoto. Por padrão, o valor é 100. Definir 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 fazer até --remote_max_connections solicitações simultâneas. Para o cache/executor remoto do gRPC, um canal gRPC geralmente pode processar mais de 100 solicitações simultâneas. Assim, 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 a serem armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
Padrão de --remote_retries=<an integer>: "5"
O número máximo de tentativas para repetir um erro temporário. Se definido como 0, as novas tentativas serão desativadas.
Padrão de --remote_retry_max_delay=<An immutable length of time.>: "5s"
O atraso máximo de espera entre novas tentativas remotas. As seguintes unidades 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.
Padrão de --remote_timeout=<An immutable length of time.>: "60s"
O tempo máximo de espera para execução remota e chamadas de cache. Para o cache REST, esse é o tempo limite de conexão e de leitura. As seguintes unidades 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"
Se os resultados de ações executadas localmente devem ser enviados por upload para o cache remoto, caso ele seja compatível e o usuário tenha autorização para isso.
--[no]remote_verify_downloads padrão: "true"
Se definido como "true", 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 você descartar o cache de análise devido a uma mudança no sistema de build, definir essa opção como "false" 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á definida.
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 / não 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 "packages" e "subpackages", //java/foo e //javatests/foo são tratados como um pacote.
--[no]build_manual_tests padrão: "false"
Força a criação de destinos de teste marcados como "manual". 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 destinos 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". Eles são regidos pelas opções de filtragem de teste, por exemplo, "--test_tag_filters"
--[no]build_tests_only padrão: "false"
Se especificado, somente as regras *_test e test_suite serão criadas, e outros destinos especificados na linha de comando serão ignorados. 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, somente o LCOV é compatível.
--[no]compile_one_dependency padrão: "false"
Compila 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 não flag são interpretados. Em vez de serem destinos a serem criados, eles são nomes de arquivos de origem. Para cada nome de arquivo de origem, um destino arbitrário que depende dele será criado.
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 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ções. Se o diretório não existir, ele será criado.
--embed_label=<a one-line string> padrão: ""
Incorporar revisão de controle de origem ou rótulo de lançamento no binário
--execution_log_binary_file=<a path> padrão: consulte a descrição
Registre os spawns executados nesse arquivo como protos SpawnExec delimitados por comprimento, de acordo com src/main/protobuf/spawn.proto. Prefira --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 deve 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 gerações executadas nesse arquivo como protos ExecLogEntry delimitados por comprimento, de acordo com src/main/protobuf/spawn.proto. Todo o arquivo é 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), --subcommands (para mostrar subcomandos na saída do terminal).
--execution_log_json_file=<a path> padrão: consulte a descrição
Registre as gerações executadas nesse arquivo como representações JSON delimitadas por nova linha de protos SpawnExec, de acordo com src/main/protobuf/spawn.proto. Prefira --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 deve classificar o registro de execução), --subcommands (para mostrar subcomandos na saída do terminal).
--[no]execution_log_sort padrão: "true"
Se o registro de execução deve ser classificado, facilitando a comparação entre 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. Aplicável apenas aos formatos binário e JSON. O formato compacto nunca é classificado.
--[no]expand_test_suites padrão: "true"
Expanda os destinos de test_suite nos testes constituintes antes da análise. Quando essa flag está ativada (o padrão), os padrões de destino negativos são aplicados aos testes da suíte. Caso contrário, eles não são. Desativar essa flag é útil quando os aspectos de nível superior são aplicados na linha de comando. Assim, é possível analisar destinos 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 ficar inativo antes que uma coleta de lixo do cache de disco ocorra. 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 de disco será coletado periodicamente como lixo para remover entradas mais antigas que essa idade. Se definido em conjunto com --experimental_disk_cache_gc_max_size, os dois 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 de disco será coletado periodicamente para ficar abaixo desse tamanho. Se definido em conjunto com --experimental_disk_cache_gc_max_age, os dois 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_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> padrão: ""
Obsoleto, substituído por "aspectos". Filtra o conjunto de metas para programar extra_actions.
--[no]experimental_extra_action_top_level_only padrão: "false"
Obsoleto, substituído por "aspectos". Agenda apenas extra_actions para destinos de nível superior.
--experimental_spawn_scheduler
Ative a execução dinâmica executando ações local e remotamente em paralelo. O Bazel gera cada ação local e remotamente e escolhe aquela que é concluída primeiro. Se uma ação for compatível com workers, a ação local será executada no modo de worker persistente. Para ativar a execução dinâmica de um mnemônico de ação individual, use as flags `--internal_spawn_scheduler` e `--strategy=<mnemonic>=dynamic`.
Expansão:
  --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 não houver nenhuma, o comando vai falhar.
Padrão de --local_termination_grace_seconds=<an integer>: "15"
Tempo de espera entre o encerramento de um processo local devido a um tempo limite e o desligamento 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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, faz com que o Bazel imprima mensagens "Carregando pacote:".
--test_lang_filters=<comma-separated list of options> padrão: ""
Especifica uma lista de idiomas de teste separados por vírgulas. 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 de 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 tamanhos excluídos. Somente os destinos de teste que contêm pelo menos um tamanho incluído e nenhum tamanho excluído serão encontrados. 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 tempos limite excluídos. Somente os destinos de teste que contêm pelo menos um tempo limite incluído e nenhum 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 ver a especificação completa. Consulte também tools/buildstamp/get_workspace_status para ver um exemplo.
Opções que controlam a execução do build:
Se é necessário 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 aar permanente usando workers.
Tags: execution, experimental
--[no]experimental_remotable_source_manifests padrão: "false"
Se as ações do manifesto de origem podem ser executadas remotamente
Tags: loading_and_analysis, execution, experimental
--[no]experimental_split_coverage_postprocessing padrão: "false"
Se for "true", o Bazel vai executar o pós-processamento de cobertura para o 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 regulares. Eles não vão percorrer diretórios nem serão sensíveis a symlinks.
Tags: execution, experimental
--[no]incompatible_modify_execution_info_additive padrão: "false"
Quando ativada, a transmissão de várias flags --modify_execution_info é cumulativa. Quando desativada, apenas a última flag é considerada.
Tags: execution, affects_outputs, loading_and_analysis, incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> vários usos são acumulados
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico dela. 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=[+-]key,regex=[+-]key,...". 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 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 dessugar do Android usando workers.
Expande 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 persistentes do Android usando workers.
Expansão:--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 e multiplexadas de dex e dessugar do Android 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 persistente 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
Ativa ferramentas persistentes e multiplexadas do Android (dexing, dessugarização, processamento de recursos).
Expande 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 for "true", 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 o combinador de manifestos a ser usado para regras android_binary. Flag para ajudar na transição da combinação legada para a combinação de manifestos do Android.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--android_platforms=<a build target label> padrão: ""
Define as plataformas usadas pelas segmentações android_binary. Se várias plataformas forem especificadas, o binário será um APK gordo, 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> default: "@bazel_tools//tools/cpp:toolchain"
O rótulo do pacote crosstool a ser usado em regras do Apple e Objc e suas dependências.
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> default: "@bazel_tools//tools/test:lcov_merger"
Localização do binário usado para pós-processar relatórios de cobertura bruta. 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> default: "@bazel_tools//tools/test:coverage_report_generator"
Localização 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> default: "@bazel_tools//tools/test:coverage_support"
Localização dos arquivos de suporte necessários nas entradas de todas as ações de teste que coletam cobertura de 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 de malloc personalizada. Essa configuração substitui os atributos malloc nas regras de build.
Tags: changes_inputs, affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> vários usos são acumulados
Lista de expressões regulares separadas por vírgulas, cada uma prefixada opcionalmente por - (expressão negativa), atribuída (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino não 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 contenha "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 todas as ações do Xcode. Se a versão do Xcode tiver um rótulo hifenizado, 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 for "true", use o Xcode mais recente disponível localmente e remotamente. Se for "false" ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada com xcode-select.
Tags: loses_incremental_state, experimental
--extra_execution_platforms=<comma-separated list of options> padrão: ""
As plataformas disponíveis como plataformas de execução para realizar ações. As plataformas podem ser especificadas por segmentação exata ou como um padrão de segmentação. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores vão substituir as configurações de flag anteriores.
Tags: execution
--extra_toolchains=<comma-separated list of options> vários usos são acumulados
As regras da cadeia de ferramentas a serem consideradas durante a resolução da cadeia de ferramentas. As toolchains podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes daqueles 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 crosstool, e quase nunca é necessário substituir esse valor.
Tags: action_command_lines, affects_outputs
--host_compiler=<a string> padrão: consulte a descrição
Flag sem operação. Será removido em uma versão futura.
Tags: loading_and_analysis, execution
--host_grte_top=<a label> padrão: consulte a descrição
Se especificada, essa configuração substitui o diretório de nível superior da libc (--grte_top) para a configuração de execução.
Tags: action_command_lines, affects_outputs
--host_platform=<a build target label> default: "@bazel_tools//tools:host_platform"
O rótulo de uma regra de plataforma que descreve o sistema 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 estiver desativado, ele vai criar "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, então o primeiro é mais correto. Isso não afeta "bazel run", que sempre cria "`--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 for "true", o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas do 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 da cadeia de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativas)
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_remove_legacy_whole_archive padrão: "true"
Se for "true", o Bazel não vai vincular dependências de biblioteca como um arquivo inteiro 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 for verdadeiro, a ação de remoção para executáveis usará a flag -x, que não interrompe a resolução dinâmica de símbolos.
Tags: action_command_lines, incompatible_change
--[no]interface_shared_objects padrão: "true"
Use objetos compartilhados de interface se o conjunto de ferramentas for compatível. Todas as toolchains ELF são compatíveis com 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 do iOS a ser usada para criar aplicativos iOS. Se não for especificado, 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, 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 que sua compilação segmenta.
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 Python invocado para executar destinos 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 rótulo de um py_runtime que representa o interpretador Python invocado para executar destinos 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 desse sistema operacional. Se não for especificado, usará a versão padrão do SDK do 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, 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 fornecida 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> default: "@bazel_tools//tools/cpp:host_xcodes"
O rótulo da regra xcode_config a ser usada para selecionar a versão do Xcode na configuração de build.
Tags: loses_incremental_state, loading_and_analysis
Opções que controlam a saída do comando:
--[no]apple_generate_dsym padrão: "false"
Se é necessário gerar arquivos de símbolos de depuração (.dSYM).
Tags: affects_outputs, action_command_lines
Se for verdadeiro, vai criar florestas de symlink de runfiles para todos os destinos. Se for "false", grave-os apenas quando exigido por uma ação, teste ou comando de execução local.
Tags: affects_outputs
--[no]build_runfile_manifests padrão: "true"
Se for "true", grava manifestos de runfiles para todas as metas. Se for "false", omita-os. Os testes locais não serão executados quando for "false".
Tags: affects_outputs
--[no]build_test_dwp padrão: "false"
Se ativado, ao criar testes em C++ de forma estática e com fusã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
Padrão de --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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"
Executa ações extras para versões alternativas da 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 fissão para compilações e vinculações 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 for verdadeiro, as regras nativas vão adicionar <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 for "true", vai criar florestas de symlink 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 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 de 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 dela, e não a existência:
--action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções 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"
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso só é usado com a vinculação de dados v2. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--[no]android_databinding_use_v3_4_args padrão: "true"
Use a vinculação de dados do Android v2 com o argumento 3.4.0. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--android_dynamic_mode=<off, default or fully> padrão: "off"
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 a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo estático.
Tags: affects_outputs, loading_and_analysis
Padrão de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alphabetical"
Define a ordem dos manifestos transmitidos à ferramenta de mescla 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 dela.
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"
Crie um zip executável do Python. Ativado no Windows e desativado em outras plataformas.
Tags: affects_outputs
--catalyst_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Apenas os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não deve ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] padrão: "fastbuild"
Especifique o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--conlyopt=<a string> vários usos são acumulados
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags: action_command_lines, affects_outputs
--copt=<a string> vários usos são acumulados
Outras opções 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 informações de 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
Gere 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 despejados durante a execução.
Tags: affects_outputs
--cs_fdo_profile=<a build target label> padrão: consulte a descrição
O cs_fdo_profile que representa o perfil sensível ao contexto a ser usado para otimização.
Tags: affects_outputs
--cxxopt=<a string> vários usos são acumulados
Opção extra para transmitir ao gcc ao compilar arquivos de origem C++.
Tags: action_command_lines, affects_outputs
--define=<a 'name=value' assignment> vários usos são acumulados
Cada opção "--define" especifica uma atribuição para uma variável de build. Em caso de vários valores para uma variável, o último vence.
Tags: changes_inputs, affects_outputs
--dynamic_mode=<off, default or fully> padrão: "default"
Determina se os binários C++ serão vinculados dinamicamente. "default" significa que o Bazel vai escolher se a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo 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 a otimização do propeller 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 symlink de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags: affects_outputs
--experimental_action_listener=<a build target label> vários usos são acumulados
Obsoleto, substituído por "aspectos". Use action_listener para anexar uma extra_action a 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 a vinculação de dados do Android v2. Essa flag não faz nada.
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 rex tool to rewrite dex files
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 do compilador objc fastbuild.
Tags: action_command_lines
--[no]experimental_omitfp padrão: "false"
Se for verdadeiro, use libunwind para desenrolar 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: "off"
Qual modelo usar para onde as regras da árvore de saída gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para mais detalhes. As ações do Starlark podem ativar o mapeamento de caminhos adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> vários usos 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. Usado somente 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 for "true", um nome abreviado para a plataforma de destino será usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e está 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 um nome abreviado para a plataforma atual foi 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 inclusão de carimbos está desativada.
Tags: affects_outputs, experimental
--[no]experimental_use_llvm_covmap padrão: "false"
Se especificado, o Bazel vai gerar informações de mapa de cobertura llvm-cov em vez de gcov quando 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. Por isso, recomendamos 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
Gere binários com a instrumentação do FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão despejados durante a execução.
Tags: affects_outputs
--fdo_optimize=<a string> padrão: consulte a descrição
Use informações de perfil da FDO para otimizar a compilação. Especifique o nome de um arquivo zip que contenha 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
--features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<recurso> desativa o recurso. Recursos negativos sempre substituem os positivos. Consulte também --host_features
Tags: changes_inputs, affects_outputs
--[no]force_pic padrão: "false"
Se ativada, todas as compilações em C++ produzem código independente de posição ("-fPIC"), as vinculações preferem bibliotecas pré-criadas PIC em vez de bibliotecas não PIC, e as vinculações produzem executáveis independentes de posição ("-pie").
Tags: loading_and_analysis, affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> padrão: "opt"
Especifique o modo em que as ferramentas usadas durante a criação serão criadas. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--host_conlyopt=<a string> vários usos são acumulados
Opção extra para transmitir ao compilador C ao compilar arquivos de origem C (mas não C++) nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_copt=<a string> vários usos são acumulados
Outras opções 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 do host.
Tags: changes_inputs, affects_outputs
--host_cxxopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de execução. Especificar -<recurso> desativa o recurso. 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
--host_linkopt=<a string> vários usos são acumulados
Opção extra 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 de host. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações de execuçã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ões regulares 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 @. Somente 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 cadeia de ferramentas usada 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 for verdadeiro, o diretório genfiles será incorporado ao diretório bin.
Tags: affects_outputs, incompatible_change
--[no]instrument_test_targets padrão: "false"
Quando a cobertura está ativada, especifica se é preciso considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. 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 especificado baseado em regex são instrumentadas. As regras com o prefixo "-" são excluídas. Somente 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, usará "ios_sdk_version".
Tags: loses_incremental_state
--ios_multi_cpus=<comma-separated list of options> vários usos 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 mais detalhes. Quando ativada, 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
--linkopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para o gcc ao vincular.
Tags: action_command_lines, affects_outputs
--ltobackendopt=<a string> vários usos são acumulados
Opção adicional para transmitir à etapa de back-end do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--ltoindexopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para a etapa de indexação do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--macos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do macOS para destinos. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--memprof_profile=<a build target label> padrão: consulte a descrição
Use o perfil memprof.
Tags: affects_outputs
--[no]objc_debug_with_GLIBCXX padrão: "false"
Se definido e o modo de compilação for "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags: action_command_lines
--[no]objc_enable_binary_stripping padrão: "false"
Se é necessário realizar a remoção de símbolos e códigos mortos em binários vinculados. A remoção de binários será realizada se esta flag e --compilation_mode=opt forem especificadas.
Tags: action_command_lines
--objccopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o gcc ao compilar arquivos de origem Objective-C/C++.
Tags: action_command_lines
--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> vários usos são acumulados
Outras opções 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ões regulares 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 @. Somente 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 gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags: action_command_lines, affects_outputs
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao back-end do 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, e 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 @. Somente 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 LTO de todos os arquivos o 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",)Talvez seja necessário adicionar uma diretiva exports_files ao pacote correspondente para tornar esses arquivos visíveis ao 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 para Propeller.
Tags: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> padrão: consulte a descrição
Nome do caminho absoluto do arquivo ld_profile para builds otimizados para 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" e "//package:target --options".
Tags: action_command_lines
--[no]share_native_deps padrão: "true"
Se for "true", 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"
Adicione carimbos aos 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
Padrão de --strip=<always, sometimes or never>: "sometimes"
Especifica se os binários e as bibliotecas compartilhadas devem ser removidos (usando "-Wl,--strip-debug"). O valor padrão "sometimes" significa remover se --compilation_mode=fastbuild.
Tags: affects_outputs
--stripopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a remoção ao gerar um binário "<name>.stripped".
Tags: action_command_lines, affects_outputs
--tvos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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, usará "tvos_sdk_version".
Tags: loses_incremental_state
--visionos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para criar binários do Apple visionOS.
Tags: loses_incremental_state, loading_and_analysis
--watchos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do watchOS para simuladores e dispositivos de destino. Se não for especificado, usará "watchos_sdk_version".
Tags: loses_incremental_state
--xbinary_fdo=<a build target label> padrão: consulte a descrição
Use informações de perfil do XbinaryFDO para otimizar a compilação. Especifique o nome do perfil 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags 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 dos destinos que estão sendo criados. 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 nas dependências de destino serão rebaixados para avisos.
Tags: build_file_semantics
--[no]desugar_for_android padrão: "true"
Se o bytecode Java 8 deve ser simplificado antes da conversão para DEX.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--[no]desugar_java8_libs padrão: "false"
Se as bibliotecas Java 8 compatíveis devem 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"
Se é necessário verificar novamente a dessugarização correta 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
No-op, 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 opção 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 for 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 testonly para destinos de pré-requisito que são arquivos de saída pesquisando 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 a implementações de cadeia de ferramentas.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_disable_native_android_rules padrão: "false"
Se ativada, 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"
No-op. Mantido aqui para compatibilidade com versões anteriores.
Tags: eagerness_to_exit, incompatible_change
--[no]incompatible_python_disable_py2 padrão: "true"
Se for verdadeiro, usar as configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15684.
Tags: loading_and_analysis, incompatible_change
--[no]one_version_enforcement_on_java_tests padrão: "true"
Quando ativada e com experimental_one_version_enforcement definido como um valor diferente de NONE, impõe uma versão em destinos java_test. Essa flag pode ser desativada para melhorar a performance do teste incremental, mas isso pode fazer com que possíveis violações de uma versão sejam perdidas.
Tags: loading_and_analysis
--python_native_rules_allowlist=<a build target label> padrão: consulte a descrição
Uma lista de permissões (destino 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 cruzam 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 OFF, 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: "off"
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente como exportados todos os destinos usados em "import public".
Tags: build_file_semantics, eagerness_to_exit, incompatible_change
--[no]strict_system_includes padrão: "false"
Se for "true", os cabeçalhos encontrados por caminhos de inclusão do sistema (-isystem) também precisarão ser declarados.
Tags: loading_and_analysis, eagerness_to_exit
--target_environment=<a build target label> vários usos são acumulados
Declara o ambiente de destino desta build. Precisa ser uma referência de rótulo a 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 incluirão 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, será usado o perfil de provisionamento. Pode ser a preferência de identidade do keychain do certificado ou (substring) do nome comum do certificado, conforme a página de manual do 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"
Sem operação, será removido em breve.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes padrão: "false"
Se for "true", não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags: build_file_semantics, incompatible_change
Se for verdadeiro, defina o valor padrão como verdadeiro para 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 devem 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 regem o comportamento do ambiente de teste ou do executor de testes:
--[no]allow_analysis_failures padrão: "false"
Se for "true", uma falha na análise de um destino de regra vai resultar na propagação 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
Padrão de --analysis_testing_deps_limit=<an integer>: "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 for "true", as falhas na ação dex2oat vão interromper o build em vez de executar dex2oat durante o tempo de execução do teste.
Tags: loading_and_analysis, experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> vários usos são acumulados
Substitua a quantidade padrão de recursos 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írgulas 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"
Ative 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 é ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags: test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> vários usos são acumulados
Especifica o número de vezes que cada teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado falho. 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 transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
--test_env=<a 'name=value' assignment with an optional value part> vários usos 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, caso em que o valor será lido do ambiente do cliente 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"
Substitui 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 uma das formas, um valor de -1 informa ao Blaze para usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs padrão: "false"
Se for "true", 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 ProGuard ProgramJar 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 em C++ serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_inmemory_jdeps_files padrão: "true"
Se ativados, os arquivos de dependência (.jdeps) gerados de compilações Java serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_retain_test_configuration_across_testonly padrão: "false"
Quando ativada, a flag --trim_test_configuration não vai remover a configuração de teste para regras marcadas como testonly=1. Isso reduz problemas de conflito de ações quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for "false".
Tags: loading_and_analysis, loses_incremental_state, experimental
--[no]experimental_starlark_cc_import padrão: "false"
Se ativada, a versão Starlark de cc_import poderá ser usada.
Tags: loading_and_analysis, experimental
--[no]experimental_unsupported_and_brittle_include_scanning padrão: "false"
Se as entradas devem ser restritas à compilação C/C++ analisando linhas #include de 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. Em particular, 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 flag que forem enviados serão encerrados.
Tags: loading_and_analysis, execution, changes_inputs, experimental
--[no]incremental_dexing padrão: "true"
Faz a maior parte do trabalho de dexagem 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 reduzir o conjunto de entradas transmitidas para 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çalho estiver ativado para a cadeia de ferramentas).
Tags: execution
--[no]trim_test_configuration padrão: "true"
Quando ativadas, as opções relacionadas a testes 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 a testes 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 detalhe, o formato ou o local do registro em log:
Padrão de --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
Imprime informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação a tipos de cadeia de ferramentas e destinos específicos para ver qual depurar. É possível separar várias expressões regulares com vírgulas, e cada uma delas é verificada separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de toolchain.
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:
--flag_alias=<a 'name=value' flag alias> vários usos 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 arquivos de execução de destinos Python. Precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (o 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 for 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 Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o symlink 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 recomendamos ativar `--incompatible_py3_is_default`. Tags do
: affects_outputs, incompatible_change
--[no]incompatible_py3_is_default padrão: "true"
Se for verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão usar PY3 em vez de PY2 por padrão. Se você definir essa flag, também recomendamos definir `--incompatible_py2_outputs_are_suffixed`. Tags do
: loading_and_analysis, affects_outputs, incompatible_change
--[no]incompatible_use_python_toolchains padrão: "true"
Se definido como "true", as regras executáveis do Python nativo vão usar o ambiente de execução do Python especificado pela cadeia 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 da versão principal do Python, `PY2` ou `PY3`. Isso é substituído por destinos `py_binary` e `py_test`, mesmo que eles não especifiquem uma versão explicitamente. Portanto, geralmente não há muito motivo para fornecer essa flag.
Tags: loading_and_analysis, affects_outputs
Opções diversas, não categorizadas de outra forma.:
--[no]cache_test_results [-t] padrão: "auto"
Se definido como "auto", o Bazel vai executar um teste novamente se e somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste forem solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "yes", o Bazel armazena em cache todos os resultados de testes, 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 for "true", o Blaze vai cancelar os testes em execução simultânea 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 for "true", o Bazel vai buscar o diretório inteiro de dados de cobertura 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 for 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"
Se é necessário gerar o mapa de cabeçalho J2ObjC em paralelo à transcompilação do J2ObjC.
Tags: experimental
--[no]experimental_j2objc_shorter_header_path padrão: "false"
Se a geração deve usar um caminho de cabeçalho mais curto ("_ios" em vez de "_j2objc").
Tags: affects_outputs, experimental
--experimental_java_classpath=<off, javabuilder or bazel> padrão: "javabuilder"
Ativa caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java padrão: "false"
No-op, mantido apenas para compatibilidade com versões anteriores
Tags: affects_outputs, experimental
--[no]experimental_run_android_lint_on_java_rules padrão: "false"
Se as fontes java_* devem 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 obter acidentalmente das dependências do TestRunner. No momento, só funciona para bazel.
--host_java_launcher=<a build target label> padrão: consulte a descrição
O inicializador Java usado por ferramentas executadas durante um build.
--host_javacopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o javac ao criar ferramentas executadas durante um build.
--host_jvmopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a VM Java ao criar ferramentas 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 for verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de testes não indicar que oferece suporte à fragmentação ao tocar no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for "false", um executor de testes que não oferece suporte ao sharding vai fazer com que todos os testes sejam executados em cada fragmento.
Tags: incompatible_change
--[no]incompatible_exclusive_test_sandboxed padrão: "true"
Se for "true", os testes exclusivos serão executados com a estratégia em sandbox. Adicione a tag "local" para forçar uma execução de teste exclusiva no local
Tags: incompatible_change
--[no]incompatible_strict_action_env padrão: "false"
Se for "true", o Bazel usará um ambiente com um valor estático para PATH e não vai herdar LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente, mas observe que 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
Outras opções a serem transmitidas para a 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 -test_output=streamed.
Expansão:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps padrão: "true"
Gere informações de dependência (por enquanto, classpath de tempo de compilação) por destino Java.
--[no]java_header_compilation padrão: "true"
Compile ijars diretamente da origem.
--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 inicializador 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.
Padrão de --java_runtime_version=<a string>: "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.
--jvmopt=<a string> vários usos 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 dexing sem sharding.
--plugin=<a build target label> vários usos são acumulados
Plug-ins a serem usados no build. No momento, funciona com java_plugin.
--proguard_top=<a build target label> padrão: consulte a descrição
Especifica qual versão do ProGuard usar para remoção de código ao criar um binário Java.
--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"
O rótulo do proto-compilador.
Tags: affects_outputs, loading_and_analysis
--[no]proto_profile padrão: "true"
Se profile_path deve ser transmitido ao 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 (o padrão), vai inferir o caminho de --fdo_optimize.
Tags: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> default: "@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> default: "@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> default: "@bazel_tools//tools/proto:javalite_toolchain"
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags: affects_outputs, loading_and_analysis
--protocopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador protobuf.
Tags: affects_outputs
--[no]runs_per_test_detects_flakes padrão: "false"
Se for "true", qualquer fragmento em que pelo menos uma execução/tentativa seja aprovada e pelo menos uma execução/tentativa falhe vai receber 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 não estiver definido, 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 dos dois estiver definido, o Bazel usará um caminho padrão codificado, 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). Usar um shell incompatível com bash pode causar falhas de build ou de tempo de execução dos binários gerados.
Tags: loading_and_analysis
--test_arg=<a string> vários usos são acumulados
Especifica outras opções e argumentos que devem ser transmitidos ao 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 a ser encaminhado para a estrutura de teste. Usado para limitar os testes executados. Isso não afeta quais destinos são criados.
--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 testes. O executor de testes 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 fragmentação de testes: "explicit" para usar a fragmentação somente se o atributo "shard_count" BUILD estiver presente. "disabled" para nunca usar o sharding de teste. "forced=k" para forçar "k" fragmentos para teste, independente do atributo "shard_count" BUILD.
--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 resulta 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"
Gere a política canônica após a expansão e a filtragem. Para manter a saída limpa, os argumentos de comando canonizados NÃO serão mostrados quando essa opção for definida como "true". 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 estão incluídas na saída.
Tags: affects_outputs, terminal_output
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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
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 canonicalizadas.
Tags: affects_outputs, terminal_output
--invocation_policy=<a string> padrão: ""
Aplica uma política de invocação às opções a serem canonicalizadas.
Tags: affects_outputs, terminal_output
Opções diversas, não categorizadas de outra forma.:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, 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 for verdadeiro, a limpeza da saída será assíncrona. Quando esse comando for concluído, será seguro 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 for "true", o comando "clean" vai remover toda a árvore de trabalho dessa instância do Bazel, incluindo todos os arquivos temporários e de saída de build criados pelo Bazel, e vai interromper 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 dessa instância do Bazel, incluindo 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 do
: host_machine_resource_optimizations
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"
Nenhuma operação.
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"
Nenhuma operação.
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"
Nenhuma operação.
Tags: loading_and_analysis
Opções relacionadas à saída e à semântica da consulta:
--aspect_deps=<off, conservative or precise> padrão: "conservative"
Como resolver dependências de aspectos quando o formato de saída é um dos seguintes: {xml,proto,record}. "off" significa que nenhuma dependência de aspecto é resolvida. "conservative" (o padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independente de terem recebido a classe de regra de dependências diretas. "precise" significa que apenas os aspectos possivelmente ativos são adicionados, considerando a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar uma única meta, o que o torna mais lento do que os outros modos. Além disso, mesmo o modo preciso não é completamente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante "bazel query".
Tags: build_file_semantics
--[no]consistent_labels padrão: "false"
Se ativado, todo comando de consulta vai emitir rótulos como se a função <code>str</code> do Starlark fosse aplicada a uma instância <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órios aparentes (em relação 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 por aspectos devem ser incluídas na saída. query: no-op (os aspectos são sempre seguidos).
Tags: terminal_output
--[no]graph:factored padrão: "true"
Se for verdadeiro, o gráfico será emitido "fatorado", ou seja, nós topologicamente equivalentes serão mesclados e seus rótulos concatenados. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--graph:node_limit=<an integer> padrão: "512"
O comprimento máximo da string de rótulo para um nó de gráfico na saída. Rótulos mais longos serão truncados. -1 significa que não haverá truncamento. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--[no]implicit_deps padrão: "true"
Se ativadas, 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 é aquela que 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 por aspectos devem ser 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", a barra dupla inicial "//" não será omitida.
Tags: terminal_output, incompatible_change
--[no]infer_universe_scope padrão: "false"
Se definido e --universe_scope não estiver definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão de 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 apenas se souber o que está fazendo. Acesse https://bazel.build/reference/query#sky-query para ver 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" (ou seja, não "cquery"). Tags do
: loading_and_analysis
--[no]line_terminator_null padrão: "false"
Indica se cada formato é encerrado com \0 em vez de uma 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 atributo "nodep" é "visibility". 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
Padrão de --output=<a string>: "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
--[no]proto:default_values padrão: "true"
Se for "true", os atributos cujo valor não estiver especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Essa opção se aplica 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 ativados, os atributos configuráveis criados por select() serão simplificados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa de seleção exatamente uma vez. Os tipos escalares são nivelados como nulos.
Tags: build_file_semantics
--[no]proto:include_attribute_source_aspects padrão: "false"
Preencha o campo proto source_aspect_name de cada atributo com o aspecto de origem de que o atributo veio (string vazia se não veio de nenhum).
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 cquery proto é semelhante ao formato de saída da consulta.
Tags: affects_outputs
--[no]proto:include_synthetic_attribute_hash padrão: "false"
Se o atributo $internal_attr_hash deve 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 exige que a pilha esteja presente.
Tags: terminal_output
--[no]proto:locations padrão: "true"
Se é necessário gerar informações de localização na saída proto.
Tags: terminal_output
Padrão de --proto:output_rule_attrs=<comma-separated list of options>: "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 e, para a primeira regra com um determinado "rule_class_key", preencha também o campo proto "rule_class_info". O campo "rule_class_key" identifica exclusivamente uma classe de regra, e o campo "rule_class_info" é uma definição de API de classe de regra no formato Stardoc.
Tags: terminal_output
--[no]proto:rule_inputs_and_outputs padrão: "true"
Se os campos "rule_input" e "rule_output" devem ser preenchidos ou não.
Tags: terminal_output
--query_file=<a string> padrão: ""
Se definido, a consulta vai ler o 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 for "true", o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de local é um caminho absoluto e não é consistente em todas 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: "off"
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 nem --starlark:expr nem --starlark:file forem especificados, essa opção vai usar o padrão "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 é aplicada a cada destino configurado para formatá-lo como uma string. É um erro especificar --starlark:expr e --starlark:file. Consulte a ajuda para --output=starlark para mais detalhes.
Tags: terminal_output
--[no]tool_deps padrão: "true"
Consulta: se desativada, as dependências da "configuração de execução" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "configuração de execução", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante a build, em vez de uma parte do mesmo programa "target". Cquery: se desativado, filtra todos os destinos configurados que cruzam uma transição de execução do destino de nível superior que descobriu esse destino configurado. Isso significa que, se o destino de nível superior estiver na configuração de destino, somente os destinos configurados que também estiverem na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, somente os destinos configurados para execução serão retornados. Essa opção NÃO exclui toolchains resolvidas.
Tags: build_file_semantics
--transitions=<full, lite or none> padrão: "none"
O formato em que o cquery vai imprimir informações de transição.
Tags: affects_outputs
--universe_scope=<comma-separated list of options> padrão: ""
Um conjunto de padrões de segmentação (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pelo fechamento transitivo das metas especificadas. Essa opção é usada para os comandos "query" e "cquery". Para cquery, a entrada dessa opção são os destinos em que todas as respostas são criadas. Portanto, essa opção pode afetar 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 da expressão de consulta. Observação: para cquery, não especificar essa opção pode fazer com que o build seja interrompido se os destinos analisados da 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:
Se é necessário 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 aar permanente usando workers.
Tags: execution, experimental
--[no]experimental_remotable_source_manifests padrão: "false"
Se as ações do manifesto de origem podem ser executadas remotamente
Tags: loading_and_analysis, execution, experimental
--[no]experimental_split_coverage_postprocessing padrão: "false"
Se for "true", o Bazel vai executar o pós-processamento de cobertura para o 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 regulares. Eles não vão percorrer diretórios nem serão sensíveis a symlinks.
Tags: execution, experimental
--[no]incompatible_modify_execution_info_additive padrão: "false"
Quando ativada, a transmissão de várias flags --modify_execution_info é cumulativa. Quando desativada, apenas a última flag é considerada.
Tags: execution, affects_outputs, loading_and_analysis, incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> vários usos são acumulados
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico dela. 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=[+-]key,regex=[+-]key,...". 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 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 dessugar do Android usando workers.
Expande 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 persistentes do Android usando workers.
Expansão:--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 e multiplexadas de dex e dessugar do Android 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 persistente 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
Ativa ferramentas persistentes e multiplexadas do Android (dexing, dessugarização, processamento de recursos).
Expande 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 for "true", 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 o combinador de manifestos a ser usado para regras android_binary. Flag para ajudar na transição da combinação legada para a combinação de manifestos do Android.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--android_platforms=<a build target label> padrão: ""
Define as plataformas usadas pelas segmentações android_binary. Se várias plataformas forem especificadas, o binário será um APK gordo, 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> default: "@bazel_tools//tools/cpp:toolchain"
O rótulo do pacote crosstool a ser usado em regras do Apple e Objc e suas dependências.
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> default: "@bazel_tools//tools/test:lcov_merger"
Localização do binário usado para pós-processar relatórios de cobertura bruta. 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> default: "@bazel_tools//tools/test:coverage_report_generator"
Localização 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> default: "@bazel_tools//tools/test:coverage_support"
Localização dos arquivos de suporte necessários nas entradas de todas as ações de teste que coletam cobertura de 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 de malloc personalizada. Essa configuração substitui os atributos malloc nas regras de build.
Tags: changes_inputs, affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> vários usos são acumulados
Lista de expressões regulares separadas por vírgulas, cada uma prefixada opcionalmente por - (expressão negativa), atribuída (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino não 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 contenha "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 todas as ações do Xcode. Se a versão do Xcode tiver um rótulo hifenizado, 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 for "true", use o Xcode mais recente disponível localmente e remotamente. Se for "false" ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada com xcode-select.
Tags: loses_incremental_state, experimental
--extra_execution_platforms=<comma-separated list of options> padrão: ""
As plataformas disponíveis como plataformas de execução para realizar ações. As plataformas podem ser especificadas por segmentação exata ou como um padrão de segmentação. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores vão substituir as configurações de flag anteriores.
Tags: execution
--extra_toolchains=<comma-separated list of options> vários usos são acumulados
As regras da cadeia de ferramentas a serem consideradas durante a resolução da cadeia de ferramentas. As toolchains podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes daqueles 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 crosstool, e quase nunca é necessário substituir esse valor.
Tags: action_command_lines, affects_outputs
--host_compiler=<a string> padrão: consulte a descrição
Flag sem operação. Será removido em uma versão futura.
Tags: loading_and_analysis, execution
--host_grte_top=<a label> padrão: consulte a descrição
Se especificada, essa configuração substitui o diretório de nível superior da libc (--grte_top) para a configuração de execução.
Tags: action_command_lines, affects_outputs
--host_platform=<a build target label> default: "@bazel_tools//tools:host_platform"
O rótulo de uma regra de plataforma que descreve o sistema 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 estiver desativado, ele vai criar "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, então o primeiro é mais correto. Isso não afeta "bazel run", que sempre cria "`--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 for "true", o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas do 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 da cadeia de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativas)
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_remove_legacy_whole_archive padrão: "true"
Se for "true", o Bazel não vai vincular dependências de biblioteca como um arquivo inteiro 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 for verdadeiro, a ação de remoção para executáveis usará a flag -x, que não interrompe a resolução dinâmica de símbolos.
Tags: action_command_lines, incompatible_change
--[no]interface_shared_objects padrão: "true"
Use objetos compartilhados de interface se o conjunto de ferramentas for compatível. Todas as toolchains ELF são compatíveis com 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 do iOS a ser usada para criar aplicativos iOS. Se não for especificado, 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, 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 que sua compilação segmenta.
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 Python invocado para executar destinos 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 rótulo de um py_runtime que representa o interpretador Python invocado para executar destinos 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 desse sistema operacional. Se não for especificado, usará a versão padrão do SDK do 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, 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 fornecida 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> default: "@bazel_tools//tools/cpp:host_xcodes"
O rótulo da regra xcode_config a ser usada para selecionar a versão do Xcode na configuração de build.
Tags: loses_incremental_state, loading_and_analysis
Opções que controlam a saída do comando:
--[no]apple_generate_dsym padrão: "false"
Se é necessário gerar arquivos de símbolos de depuração (.dSYM).
Tags: affects_outputs, action_command_lines
Se for verdadeiro, vai criar florestas de symlink de runfiles para todos os destinos. Se for "false", grave-os apenas quando exigido por uma ação, teste ou comando de execução local.
Tags: affects_outputs
--[no]build_runfile_manifests padrão: "true"
Se for "true", grava manifestos de runfiles para todas as metas. Se for "false", omita-os. Os testes locais não serão executados quando for "false".
Tags: affects_outputs
--[no]build_test_dwp padrão: "false"
Se ativado, ao criar testes em C++ de forma estática e com fusã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
Padrão de --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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"
Executa ações extras para versões alternativas da 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 fissão para compilações e vinculações 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 for verdadeiro, as regras nativas vão adicionar <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 for "true", vai criar florestas de symlink 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 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 de 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 dela, e não a existência:
--action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções 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"
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso só é usado com a vinculação de dados v2. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--[no]android_databinding_use_v3_4_args padrão: "true"
Use a vinculação de dados do Android v2 com o argumento 3.4.0. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--android_dynamic_mode=<off, default or fully> padrão: "off"
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 a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo estático.
Tags: affects_outputs, loading_and_analysis
Padrão de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alphabetical"
Define a ordem dos manifestos transmitidos à ferramenta de mescla 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 dela.
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"
Crie um zip executável do Python. Ativado no Windows e desativado em outras plataformas.
Tags: affects_outputs
--catalyst_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Apenas os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não deve ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] padrão: "fastbuild"
Especifique o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--conlyopt=<a string> vários usos são acumulados
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags: action_command_lines, affects_outputs
--copt=<a string> vários usos são acumulados
Outras opções 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 informações de 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
Gere 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 despejados durante a execução.
Tags: affects_outputs
--cs_fdo_profile=<a build target label> padrão: consulte a descrição
O cs_fdo_profile que representa o perfil sensível ao contexto a ser usado para otimização.
Tags: affects_outputs
--cxxopt=<a string> vários usos são acumulados
Opção extra para transmitir ao gcc ao compilar arquivos de origem C++.
Tags: action_command_lines, affects_outputs
--define=<a 'name=value' assignment> vários usos são acumulados
Cada opção "--define" especifica uma atribuição para uma variável de build. Em caso de vários valores para uma variável, o último vence.
Tags: changes_inputs, affects_outputs
--dynamic_mode=<off, default or fully> padrão: "default"
Determina se os binários C++ serão vinculados dinamicamente. "default" significa que o Bazel vai escolher se a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo 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 a otimização do propeller 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 symlink de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags: affects_outputs
--experimental_action_listener=<a build target label> vários usos são acumulados
Obsoleto, substituído por "aspectos". Use action_listener para anexar uma extra_action a 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 a vinculação de dados do Android v2. Essa flag não faz nada.
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 rex tool to rewrite dex files
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 do compilador objc fastbuild.
Tags: action_command_lines
--[no]experimental_omitfp padrão: "false"
Se for verdadeiro, use libunwind para desenrolar 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: "off"
Qual modelo usar para onde as regras da árvore de saída gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para mais detalhes. As ações do Starlark podem ativar o mapeamento de caminhos adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> vários usos 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. Usado somente 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 for "true", um nome abreviado para a plataforma de destino será usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e está 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 um nome abreviado para a plataforma atual foi 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 inclusão de carimbos está desativada.
Tags: affects_outputs, experimental
--[no]experimental_use_llvm_covmap padrão: "false"
Se especificado, o Bazel vai gerar informações de mapa de cobertura llvm-cov em vez de gcov quando 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. Por isso, recomendamos 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
Gere binários com a instrumentação do FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão despejados durante a execução.
Tags: affects_outputs
--fdo_optimize=<a string> padrão: consulte a descrição
Use informações de perfil da FDO para otimizar a compilação. Especifique o nome de um arquivo zip que contenha 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
--features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<recurso> desativa o recurso. Recursos negativos sempre substituem os positivos. Consulte também --host_features
Tags: changes_inputs, affects_outputs
--[no]force_pic padrão: "false"
Se ativada, todas as compilações em C++ produzem código independente de posição ("-fPIC"), as vinculações preferem bibliotecas pré-criadas PIC em vez de bibliotecas não PIC, e as vinculações produzem executáveis independentes de posição ("-pie").
Tags: loading_and_analysis, affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> padrão: "opt"
Especifique o modo em que as ferramentas usadas durante a criação serão criadas. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--host_conlyopt=<a string> vários usos são acumulados
Opção extra para transmitir ao compilador C ao compilar arquivos de origem C (mas não C++) nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_copt=<a string> vários usos são acumulados
Outras opções 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 do host.
Tags: changes_inputs, affects_outputs
--host_cxxopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de execução. Especificar -<recurso> desativa o recurso. 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
--host_linkopt=<a string> vários usos são acumulados
Opção extra 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 de host. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações de execuçã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ões regulares 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 @. Somente 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 cadeia de ferramentas usada 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 for verdadeiro, o diretório genfiles será incorporado ao diretório bin.
Tags: affects_outputs, incompatible_change
--[no]instrument_test_targets padrão: "false"
Quando a cobertura está ativada, especifica se é preciso considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. 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 especificado baseado em regex são instrumentadas. As regras com o prefixo "-" são excluídas. Somente 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, usará "ios_sdk_version".
Tags: loses_incremental_state
--ios_multi_cpus=<comma-separated list of options> vários usos 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 mais detalhes. Quando ativada, 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
--linkopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para o gcc ao vincular.
Tags: action_command_lines, affects_outputs
--ltobackendopt=<a string> vários usos são acumulados
Opção adicional para transmitir à etapa de back-end do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--ltoindexopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para a etapa de indexação do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--macos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do macOS para destinos. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--memprof_profile=<a build target label> padrão: consulte a descrição
Use o perfil memprof.
Tags: affects_outputs
--[no]objc_debug_with_GLIBCXX padrão: "false"
Se definido e o modo de compilação for "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags: action_command_lines
--[no]objc_enable_binary_stripping padrão: "false"
Se é necessário realizar a remoção de símbolos e códigos mortos em binários vinculados. A remoção de binários será realizada se esta flag e --compilation_mode=opt forem especificadas.
Tags: action_command_lines
--objccopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o gcc ao compilar arquivos de origem Objective-C/C++.
Tags: action_command_lines
--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> vários usos são acumulados
Outras opções 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ões regulares 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 @. Somente 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 gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags: action_command_lines, affects_outputs
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao back-end do 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, e 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 @. Somente 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 LTO de todos os arquivos o 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",)Talvez seja necessário adicionar uma diretiva exports_files ao pacote correspondente para tornar esses arquivos visíveis ao 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 para Propeller.
Tags: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> padrão: consulte a descrição
Nome do caminho absoluto do arquivo ld_profile para builds otimizados para 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" e "//package:target --options".
Tags: action_command_lines
--[no]share_native_deps padrão: "true"
Se for "true", 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"
Adicione carimbos aos 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
Padrão de --strip=<always, sometimes or never>: "sometimes"
Especifica se os binários e as bibliotecas compartilhadas devem ser removidos (usando "-Wl,--strip-debug"). O valor padrão "sometimes" significa remover se --compilation_mode=fastbuild.
Tags: affects_outputs
--stripopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a remoção ao gerar um binário "<name>.stripped".
Tags: action_command_lines, affects_outputs
--tvos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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, usará "tvos_sdk_version".
Tags: loses_incremental_state
--visionos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para criar binários do Apple visionOS.
Tags: loses_incremental_state, loading_and_analysis
--watchos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do watchOS para simuladores e dispositivos de destino. Se não for especificado, usará "watchos_sdk_version".
Tags: loses_incremental_state
--xbinary_fdo=<a build target label> padrão: consulte a descrição
Use informações de perfil do XbinaryFDO para otimizar a compilação. Especifique o nome do perfil 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags 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 dos destinos que estão sendo criados. 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 nas dependências de destino serão rebaixados para avisos.
Tags: build_file_semantics
--[no]desugar_for_android padrão: "true"
Se o bytecode Java 8 deve ser simplificado antes da conversão para DEX.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--[no]desugar_java8_libs padrão: "false"
Se as bibliotecas Java 8 compatíveis devem 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"
Se é necessário verificar novamente a dessugarização correta 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
No-op, 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 opção 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 for 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 testonly para destinos de pré-requisito que são arquivos de saída pesquisando 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 a implementações de cadeia de ferramentas.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_disable_native_android_rules padrão: "false"
Se ativada, 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"
No-op. Mantido aqui para compatibilidade com versões anteriores.
Tags: eagerness_to_exit, incompatible_change
--[no]incompatible_python_disable_py2 padrão: "true"
Se for verdadeiro, usar as configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15684.
Tags: loading_and_analysis, incompatible_change
--[no]one_version_enforcement_on_java_tests padrão: "true"
Quando ativada e com experimental_one_version_enforcement definido como um valor diferente de NONE, impõe uma versão em destinos java_test. Essa flag pode ser desativada para melhorar a performance do teste incremental, mas isso pode fazer com que possíveis violações de uma versão sejam perdidas.
Tags: loading_and_analysis
--python_native_rules_allowlist=<a build target label> padrão: consulte a descrição
Uma lista de permissões (destino 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 cruzam 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 OFF, 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: "off"
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente como exportados todos os destinos usados em "import public".
Tags: build_file_semantics, eagerness_to_exit, incompatible_change
--[no]strict_system_includes padrão: "false"
Se for "true", os cabeçalhos encontrados por caminhos de inclusão do sistema (-isystem) também precisarão ser declarados.
Tags: loading_and_analysis, eagerness_to_exit
--target_environment=<a build target label> vários usos são acumulados
Declara o ambiente de destino desta build. Precisa ser uma referência de rótulo a 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 incluirão 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, será usado o perfil de provisionamento. Pode ser a preferência de identidade do keychain do certificado ou (substring) do nome comum do certificado, conforme a página de manual do 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"
Sem operação, será removido em breve.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes padrão: "false"
Se for "true", não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags: build_file_semantics, incompatible_change
Se for verdadeiro, defina o valor padrão como verdadeiro para 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 devem 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 regem o comportamento do ambiente de teste ou do executor de testes:
--[no]allow_analysis_failures padrão: "false"
Se for "true", uma falha na análise de um destino de regra vai resultar na propagação 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
Padrão de --analysis_testing_deps_limit=<an integer>: "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 for "true", as falhas na ação dex2oat vão interromper o build em vez de executar dex2oat durante o tempo de execução do teste.
Tags: loading_and_analysis, experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> vários usos são acumulados
Substitua a quantidade padrão de recursos 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írgulas 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"
Ative 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 é ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags: test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> vários usos são acumulados
Especifica o número de vezes que cada teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado falho. 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 transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
--test_env=<a 'name=value' assignment with an optional value part> vários usos 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, caso em que o valor será lido do ambiente do cliente 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"
Substitui 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 uma das formas, um valor de -1 informa ao Blaze para usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs padrão: "false"
Se for "true", 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 ProGuard ProgramJar 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 em C++ serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_inmemory_jdeps_files padrão: "true"
Se ativados, os arquivos de dependência (.jdeps) gerados de compilações Java serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_retain_test_configuration_across_testonly padrão: "false"
Quando ativada, a flag --trim_test_configuration não vai remover a configuração de teste para regras marcadas como testonly=1. Isso reduz problemas de conflito de ações quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for "false".
Tags: loading_and_analysis, loses_incremental_state, experimental
--[no]experimental_starlark_cc_import padrão: "false"
Se ativada, a versão Starlark de cc_import poderá ser usada.
Tags: loading_and_analysis, experimental
--[no]experimental_unsupported_and_brittle_include_scanning padrão: "false"
Se as entradas devem ser restritas à compilação C/C++ analisando linhas #include de 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. Em particular, 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 flag que forem enviados serão encerrados.
Tags: loading_and_analysis, execution, changes_inputs, experimental
--[no]incremental_dexing padrão: "true"
Faz a maior parte do trabalho de dexagem 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 reduzir o conjunto de entradas transmitidas para 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çalho estiver ativado para a cadeia de ferramentas).
Tags: execution
--[no]trim_test_configuration padrão: "true"
Quando ativadas, as opções relacionadas a testes 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 a testes 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 detalhe, o formato ou o local do registro em log:
Padrão de --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
Imprime informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação a tipos de cadeia de ferramentas e destinos específicos para ver qual depurar. É possível separar várias expressões regulares com vírgulas, e cada uma delas é verificada separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de toolchain.
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:
--flag_alias=<a 'name=value' flag alias> vários usos 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 arquivos de execução de destinos Python. Precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (o 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 for 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 Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o symlink 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 recomendamos ativar `--incompatible_py3_is_default`. Tags do
: affects_outputs, incompatible_change
--[no]incompatible_py3_is_default padrão: "true"
Se for verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão usar PY3 em vez de PY2 por padrão. Se você definir essa flag, também recomendamos definir `--incompatible_py2_outputs_are_suffixed`. Tags do
: loading_and_analysis, affects_outputs, incompatible_change
--[no]incompatible_use_python_toolchains padrão: "true"
Se definido como "true", as regras executáveis do Python nativo vão usar o ambiente de execução do Python especificado pela cadeia 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 da versão principal do Python, `PY2` ou `PY3`. Isso é substituído por destinos `py_binary` e `py_test`, mesmo que eles não especifiquem uma versão explicitamente. Portanto, geralmente não há muito motivo para fornecer essa flag.
Tags: loading_and_analysis, affects_outputs
Opções diversas, não categorizadas de outra forma.:
--[no]cache_test_results [-t] padrão: "auto"
Se definido como "auto", o Bazel vai executar um teste novamente se e somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste forem solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "yes", o Bazel armazena em cache todos os resultados de testes, 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 for "true", o Blaze vai cancelar os testes em execução simultânea 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 for "true", o Bazel vai buscar o diretório inteiro de dados de cobertura 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 for 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"
Se é necessário gerar o mapa de cabeçalho J2ObjC em paralelo à transcompilação do J2ObjC.
Tags: experimental
--[no]experimental_j2objc_shorter_header_path padrão: "false"
Se a geração deve usar um caminho de cabeçalho mais curto ("_ios" em vez de "_j2objc").
Tags: affects_outputs, experimental
--experimental_java_classpath=<off, javabuilder or bazel> padrão: "javabuilder"
Ativa caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java padrão: "false"
No-op, mantido apenas para compatibilidade com versões anteriores
Tags: affects_outputs, experimental
--[no]experimental_run_android_lint_on_java_rules padrão: "false"
Se as fontes java_* devem 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 obter acidentalmente das dependências do TestRunner. No momento, só funciona para bazel.
--host_java_launcher=<a build target label> padrão: consulte a descrição
O inicializador Java usado por ferramentas executadas durante um build.
--host_javacopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o javac ao criar ferramentas executadas durante um build.
--host_jvmopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a VM Java ao criar ferramentas 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 for verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de testes não indicar que oferece suporte à fragmentação ao tocar no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for "false", um executor de testes que não oferece suporte ao sharding vai fazer com que todos os testes sejam executados em cada fragmento.
Tags: incompatible_change
--[no]incompatible_exclusive_test_sandboxed padrão: "true"
Se for "true", os testes exclusivos serão executados com a estratégia em sandbox. Adicione a tag "local" para forçar uma execução de teste exclusiva no local
Tags: incompatible_change
--[no]incompatible_strict_action_env padrão: "false"
Se for "true", o Bazel usará um ambiente com um valor estático para PATH e não vai herdar LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente, mas observe que 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
Outras opções a serem transmitidas para a 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 -test_output=streamed.
Expansão:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps padrão: "true"
Gere informações de dependência (por enquanto, classpath de tempo de compilação) por destino Java.
--[no]java_header_compilation padrão: "true"
Compile ijars diretamente da origem.
--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 inicializador 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.
Padrão de --java_runtime_version=<a string>: "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.
--jvmopt=<a string> vários usos 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 dexing sem sharding.
--plugin=<a build target label> vários usos são acumulados
Plug-ins a serem usados no build. No momento, funciona com java_plugin.
--proguard_top=<a build target label> padrão: consulte a descrição
Especifica qual versão do ProGuard usar para remoção de código ao criar um binário Java.
--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"
O rótulo do proto-compilador.
Tags: affects_outputs, loading_and_analysis
--[no]proto_profile padrão: "true"
Se profile_path deve ser transmitido ao 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 (o padrão), vai inferir o caminho de --fdo_optimize.
Tags: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> default: "@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> default: "@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> default: "@bazel_tools//tools/proto:javalite_toolchain"
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags: affects_outputs, loading_and_analysis
--protocopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador protobuf.
Tags: affects_outputs
--[no]runs_per_test_detects_flakes padrão: "false"
Se for "true", qualquer fragmento em que pelo menos uma execução/tentativa seja aprovada e pelo menos uma execução/tentativa falhe vai receber 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 não estiver definido, 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 dos dois estiver definido, o Bazel usará um caminho padrão codificado, 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). Usar um shell incompatível com bash pode causar falhas de build ou de tempo de execução dos binários gerados.
Tags: loading_and_analysis
--test_arg=<a string> vários usos são acumulados
Especifica outras opções e argumentos que devem ser transmitidos ao 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 a ser encaminhado para a estrutura de teste. Usado para limitar os testes executados. Isso não afeta quais destinos são criados.
--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 testes. O executor de testes 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 fragmentação de testes: "explicit" para usar a fragmentação somente se o atributo "shard_count" BUILD estiver presente. "disabled" para nunca usar o sharding de teste. "forced=k" para forçar "k" fragmentos para teste, independente do atributo "shard_count" BUILD.
--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 resulta em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.

Opções de dump

Opções que controlam a saída do comando:
--[no]action_cache padrão: "false"
Despeje o conteúdo do cache de ações.
Tags: bazel_monitoring
--memory=<memory mode> padrão: consulte a descrição
Despeja o uso de memória do nó do Skyframe especificado.
Tags: bazel_monitoring
--[no]packages padrão: "false"
Despeje o conteúdo do cache do pacote.
Tags: bazel_monitoring
--[no]rule_classes padrão: "false"
Despeja 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: "off"
Despeje o gráfico do Skyframe.
Tags: bazel_monitoring
Padrão de --skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ".*"
Filtro de expressão regular de nomes de 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
Despeja 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"
Nenhuma operação.
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 ou argumento for fornecido. Só funciona quando --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 o destino com falha e aqueles que dependem dele não possam ser analisados, outros pré-requisitos desses destinos 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"), opcionalmente seguida 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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
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 "configurar" para fins de configuração do sistema. Só funciona quando --enable_bzlmod está ativado.
Tags: changes_inputs
--[no]force padrão: "false"
Ignora o repositório atual, se houver, e força a busca novamente. Só funciona quando --enable_bzlmod está ativado.
Tags: changes_inputs
--repo=<a string> vários usos são acumulados
Busca apenas o repositório especificado, que pode ser {@apparent_repo_name} ou {@@canonical_repo_name}. Só funciona quando --enable_bzlmod está ativado.
Tags: changes_inputs
Opções que afetam a verbosidade, o formato ou o local do registro em log:
--experimental_repository_resolved_file=<a string> padrão: ""
Se não estiver vazio, grave um valor Starlark com as informações resolvidas de todas as regras de repositório Starlark executadas.
Tags: affects_outputs
Opções diversas, não categorizadas de outra forma:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções que controlam a execução do build:
Se é necessário 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 aar permanente usando workers.
Tags: execution, experimental
--[no]experimental_remotable_source_manifests padrão: "false"
Se as ações do manifesto de origem podem ser executadas remotamente
Tags: loading_and_analysis, execution, experimental
--[no]experimental_split_coverage_postprocessing padrão: "false"
Se for "true", o Bazel vai executar o pós-processamento de cobertura para o 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 regulares. Eles não vão percorrer diretórios nem serão sensíveis a symlinks.
Tags: execution, experimental
--[no]incompatible_modify_execution_info_additive padrão: "false"
Quando ativada, a transmissão de várias flags --modify_execution_info é cumulativa. Quando desativada, apenas a última flag é considerada.
Tags: execution, affects_outputs, loading_and_analysis, incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> vários usos são acumulados
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico dela. 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=[+-]key,regex=[+-]key,...". 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 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 dessugar do Android usando workers.
Expande 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 persistentes do Android usando workers.
Expansão:--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 e multiplexadas de dex e dessugar do Android 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 persistente 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
Ativa ferramentas persistentes e multiplexadas do Android (dexing, dessugarização, processamento de recursos).
Expande 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 for "true", 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 o combinador de manifestos a ser usado para regras android_binary. Flag para ajudar na transição da combinação legada para a combinação de manifestos do Android.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--android_platforms=<a build target label> padrão: ""
Define as plataformas usadas pelas segmentações android_binary. Se várias plataformas forem especificadas, o binário será um APK gordo, 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> default: "@bazel_tools//tools/cpp:toolchain"
O rótulo do pacote crosstool a ser usado em regras do Apple e Objc e suas dependências.
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> default: "@bazel_tools//tools/test:lcov_merger"
Localização do binário usado para pós-processar relatórios de cobertura bruta. 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> default: "@bazel_tools//tools/test:coverage_report_generator"
Localização 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> default: "@bazel_tools//tools/test:coverage_support"
Localização dos arquivos de suporte necessários nas entradas de todas as ações de teste que coletam cobertura de 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 de malloc personalizada. Essa configuração substitui os atributos malloc nas regras de build.
Tags: changes_inputs, affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> vários usos são acumulados
Lista de expressões regulares separadas por vírgulas, cada uma prefixada opcionalmente por - (expressão negativa), atribuída (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino não 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 contenha "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 todas as ações do Xcode. Se a versão do Xcode tiver um rótulo hifenizado, 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 for "true", use o Xcode mais recente disponível localmente e remotamente. Se for "false" ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada com xcode-select.
Tags: loses_incremental_state, experimental
--extra_execution_platforms=<comma-separated list of options> padrão: ""
As plataformas disponíveis como plataformas de execução para realizar ações. As plataformas podem ser especificadas por segmentação exata ou como um padrão de segmentação. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores vão substituir as configurações de flag anteriores.
Tags: execution
--extra_toolchains=<comma-separated list of options> vários usos são acumulados
As regras da cadeia de ferramentas a serem consideradas durante a resolução da cadeia de ferramentas. As toolchains podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes daqueles 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 crosstool, e quase nunca é necessário substituir esse valor.
Tags: action_command_lines, affects_outputs
--host_compiler=<a string> padrão: consulte a descrição
Flag sem operação. Será removido em uma versão futura.
Tags: loading_and_analysis, execution
--host_grte_top=<a label> padrão: consulte a descrição
Se especificada, essa configuração substitui o diretório de nível superior da libc (--grte_top) para a configuração de execução.
Tags: action_command_lines, affects_outputs
--host_platform=<a build target label> default: "@bazel_tools//tools:host_platform"
O rótulo de uma regra de plataforma que descreve o sistema 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 estiver desativado, ele vai criar "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, então o primeiro é mais correto. Isso não afeta "bazel run", que sempre cria "`--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 for "true", o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas do 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 da cadeia de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativas)
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_remove_legacy_whole_archive padrão: "true"
Se for "true", o Bazel não vai vincular dependências de biblioteca como um arquivo inteiro 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 for verdadeiro, a ação de remoção para executáveis usará a flag -x, que não interrompe a resolução dinâmica de símbolos.
Tags: action_command_lines, incompatible_change
--[no]interface_shared_objects padrão: "true"
Use objetos compartilhados de interface se o conjunto de ferramentas for compatível. Todas as toolchains ELF são compatíveis com 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 do iOS a ser usada para criar aplicativos iOS. Se não for especificado, 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, 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 que sua compilação segmenta.
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 Python invocado para executar destinos 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 rótulo de um py_runtime que representa o interpretador Python invocado para executar destinos 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 desse sistema operacional. Se não for especificado, usará a versão padrão do SDK do 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, 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 fornecida 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> default: "@bazel_tools//tools/cpp:host_xcodes"
O rótulo da regra xcode_config a ser usada para selecionar a versão do Xcode na configuração de build.
Tags: loses_incremental_state, loading_and_analysis
Opções que controlam a saída do comando:
--[no]apple_generate_dsym padrão: "false"
Se é necessário gerar arquivos de símbolos de depuração (.dSYM).
Tags: affects_outputs, action_command_lines
Se for verdadeiro, vai criar florestas de symlink de runfiles para todos os destinos. Se for "false", grave-os apenas quando exigido por uma ação, teste ou comando de execução local.
Tags: affects_outputs
--[no]build_runfile_manifests padrão: "true"
Se for "true", grava manifestos de runfiles para todas as metas. Se for "false", omita-os. Os testes locais não serão executados quando for "false".
Tags: affects_outputs
--[no]build_test_dwp padrão: "false"
Se ativado, ao criar testes em C++ de forma estática e com fusã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
Padrão de --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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"
Executa ações extras para versões alternativas da 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 fissão para compilações e vinculações 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 for verdadeiro, as regras nativas vão adicionar <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 for "true", vai criar florestas de symlink 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 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 de 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 dela, e não a existência:
--action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções 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"
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso só é usado com a vinculação de dados v2. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--[no]android_databinding_use_v3_4_args padrão: "true"
Use a vinculação de dados do Android v2 com o argumento 3.4.0. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--android_dynamic_mode=<off, default or fully> padrão: "off"
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 a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo estático.
Tags: affects_outputs, loading_and_analysis
Padrão de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alphabetical"
Define a ordem dos manifestos transmitidos à ferramenta de mescla 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 dela.
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"
Crie um zip executável do Python. Ativado no Windows e desativado em outras plataformas.
Tags: affects_outputs
--catalyst_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Apenas os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não deve ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] padrão: "fastbuild"
Especifique o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--conlyopt=<a string> vários usos são acumulados
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags: action_command_lines, affects_outputs
--copt=<a string> vários usos são acumulados
Outras opções 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 informações de 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
Gere 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 despejados durante a execução.
Tags: affects_outputs
--cs_fdo_profile=<a build target label> padrão: consulte a descrição
O cs_fdo_profile que representa o perfil sensível ao contexto a ser usado para otimização.
Tags: affects_outputs
--cxxopt=<a string> vários usos são acumulados
Opção extra para transmitir ao gcc ao compilar arquivos de origem C++.
Tags: action_command_lines, affects_outputs
--define=<a 'name=value' assignment> vários usos são acumulados
Cada opção "--define" especifica uma atribuição para uma variável de build. Em caso de vários valores para uma variável, o último vence.
Tags: changes_inputs, affects_outputs
--dynamic_mode=<off, default or fully> padrão: "default"
Determina se os binários C++ serão vinculados dinamicamente. "default" significa que o Bazel vai escolher se a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo 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 a otimização do propeller 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 symlink de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags: affects_outputs
--experimental_action_listener=<a build target label> vários usos são acumulados
Obsoleto, substituído por "aspectos". Use action_listener para anexar uma extra_action a 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 a vinculação de dados do Android v2. Essa flag não faz nada.
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 rex tool to rewrite dex files
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 do compilador objc fastbuild.
Tags: action_command_lines
--[no]experimental_omitfp padrão: "false"
Se for verdadeiro, use libunwind para desenrolar 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: "off"
Qual modelo usar para onde as regras da árvore de saída gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para mais detalhes. As ações do Starlark podem ativar o mapeamento de caminhos adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> vários usos 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. Usado somente 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 for "true", um nome abreviado para a plataforma de destino será usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e está 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 um nome abreviado para a plataforma atual foi 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 inclusão de carimbos está desativada.
Tags: affects_outputs, experimental
--[no]experimental_use_llvm_covmap padrão: "false"
Se especificado, o Bazel vai gerar informações de mapa de cobertura llvm-cov em vez de gcov quando 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. Por isso, recomendamos 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
Gere binários com a instrumentação do FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão despejados durante a execução.
Tags: affects_outputs
--fdo_optimize=<a string> padrão: consulte a descrição
Use informações de perfil da FDO para otimizar a compilação. Especifique o nome de um arquivo zip que contenha 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
--features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<recurso> desativa o recurso. Recursos negativos sempre substituem os positivos. Consulte também --host_features
Tags: changes_inputs, affects_outputs
--[no]force_pic padrão: "false"
Se ativada, todas as compilações em C++ produzem código independente de posição ("-fPIC"), as vinculações preferem bibliotecas pré-criadas PIC em vez de bibliotecas não PIC, e as vinculações produzem executáveis independentes de posição ("-pie").
Tags: loading_and_analysis, affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> padrão: "opt"
Especifique o modo em que as ferramentas usadas durante a criação serão criadas. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--host_conlyopt=<a string> vários usos são acumulados
Opção extra para transmitir ao compilador C ao compilar arquivos de origem C (mas não C++) nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_copt=<a string> vários usos são acumulados
Outras opções 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 do host.
Tags: changes_inputs, affects_outputs
--host_cxxopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de execução. Especificar -<recurso> desativa o recurso. 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
--host_linkopt=<a string> vários usos são acumulados
Opção extra 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 de host. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações de execuçã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ões regulares 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 @. Somente 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 cadeia de ferramentas usada 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 for verdadeiro, o diretório genfiles será incorporado ao diretório bin.
Tags: affects_outputs, incompatible_change
--[no]instrument_test_targets padrão: "false"
Quando a cobertura está ativada, especifica se é preciso considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. 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 especificado baseado em regex são instrumentadas. As regras com o prefixo "-" são excluídas. Somente 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, usará "ios_sdk_version".
Tags: loses_incremental_state
--ios_multi_cpus=<comma-separated list of options> vários usos 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 mais detalhes. Quando ativada, 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
--linkopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para o gcc ao vincular.
Tags: action_command_lines, affects_outputs
--ltobackendopt=<a string> vários usos são acumulados
Opção adicional para transmitir à etapa de back-end do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--ltoindexopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para a etapa de indexação do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--macos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do macOS para destinos. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--memprof_profile=<a build target label> padrão: consulte a descrição
Use o perfil memprof.
Tags: affects_outputs
--[no]objc_debug_with_GLIBCXX padrão: "false"
Se definido e o modo de compilação for "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags: action_command_lines
--[no]objc_enable_binary_stripping padrão: "false"
Se é necessário realizar a remoção de símbolos e códigos mortos em binários vinculados. A remoção de binários será realizada se esta flag e --compilation_mode=opt forem especificadas.
Tags: action_command_lines
--objccopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o gcc ao compilar arquivos de origem Objective-C/C++.
Tags: action_command_lines
--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> vários usos são acumulados
Outras opções 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ões regulares 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 @. Somente 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 gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags: action_command_lines, affects_outputs
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao back-end do 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, e 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 @. Somente 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 LTO de todos os arquivos o 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",)Talvez seja necessário adicionar uma diretiva exports_files ao pacote correspondente para tornar esses arquivos visíveis ao 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 para Propeller.
Tags: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> padrão: consulte a descrição
Nome do caminho absoluto do arquivo ld_profile para builds otimizados para 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" e "//package:target --options".
Tags: action_command_lines
--[no]share_native_deps padrão: "true"
Se for "true", 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"
Adicione carimbos aos 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
Padrão de --strip=<always, sometimes or never>: "sometimes"
Especifica se os binários e as bibliotecas compartilhadas devem ser removidos (usando "-Wl,--strip-debug"). O valor padrão "sometimes" significa remover se --compilation_mode=fastbuild.
Tags: affects_outputs
--stripopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a remoção ao gerar um binário "<name>.stripped".
Tags: action_command_lines, affects_outputs
--tvos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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, usará "tvos_sdk_version".
Tags: loses_incremental_state
--visionos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para criar binários do Apple visionOS.
Tags: loses_incremental_state, loading_and_analysis
--watchos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do watchOS para simuladores e dispositivos de destino. Se não for especificado, usará "watchos_sdk_version".
Tags: loses_incremental_state
--xbinary_fdo=<a build target label> padrão: consulte a descrição
Use informações de perfil do XbinaryFDO para otimizar a compilação. Especifique o nome do perfil 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags 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 dos destinos que estão sendo criados. 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 nas dependências de destino serão rebaixados para avisos.
Tags: build_file_semantics
--[no]desugar_for_android padrão: "true"
Se o bytecode Java 8 deve ser simplificado antes da conversão para DEX.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--[no]desugar_java8_libs padrão: "false"
Se as bibliotecas Java 8 compatíveis devem 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"
Se é necessário verificar novamente a dessugarização correta 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
No-op, 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 opção 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 for 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 testonly para destinos de pré-requisito que são arquivos de saída pesquisando 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 a implementações de cadeia de ferramentas.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_disable_native_android_rules padrão: "false"
Se ativada, 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"
No-op. Mantido aqui para compatibilidade com versões anteriores.
Tags: eagerness_to_exit, incompatible_change
--[no]incompatible_python_disable_py2 padrão: "true"
Se for verdadeiro, usar as configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15684.
Tags: loading_and_analysis, incompatible_change
--[no]one_version_enforcement_on_java_tests padrão: "true"
Quando ativada e com experimental_one_version_enforcement definido como um valor diferente de NONE, impõe uma versão em destinos java_test. Essa flag pode ser desativada para melhorar a performance do teste incremental, mas isso pode fazer com que possíveis violações de uma versão sejam perdidas.
Tags: loading_and_analysis
--python_native_rules_allowlist=<a build target label> padrão: consulte a descrição
Uma lista de permissões (destino 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 cruzam 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 OFF, 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: "off"
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente como exportados todos os destinos usados em "import public".
Tags: build_file_semantics, eagerness_to_exit, incompatible_change
--[no]strict_system_includes padrão: "false"
Se for "true", os cabeçalhos encontrados por caminhos de inclusão do sistema (-isystem) também precisarão ser declarados.
Tags: loading_and_analysis, eagerness_to_exit
--target_environment=<a build target label> vários usos são acumulados
Declara o ambiente de destino desta build. Precisa ser uma referência de rótulo a 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 incluirão 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, será usado o perfil de provisionamento. Pode ser a preferência de identidade do keychain do certificado ou (substring) do nome comum do certificado, conforme a página de manual do 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"
Sem operação, será removido em breve.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes padrão: "false"
Se for "true", não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags: build_file_semantics, incompatible_change
Se for verdadeiro, defina o valor padrão como verdadeiro para 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 devem 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 regem o comportamento do ambiente de teste ou do executor de testes:
--[no]allow_analysis_failures padrão: "false"
Se for "true", uma falha na análise de um destino de regra vai resultar na propagação 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
Padrão de --analysis_testing_deps_limit=<an integer>: "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 for "true", as falhas na ação dex2oat vão interromper o build em vez de executar dex2oat durante o tempo de execução do teste.
Tags: loading_and_analysis, experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> vários usos são acumulados
Substitua a quantidade padrão de recursos 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írgulas 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"
Ative 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 é ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags: test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> vários usos são acumulados
Especifica o número de vezes que cada teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado falho. 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 transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
--test_env=<a 'name=value' assignment with an optional value part> vários usos 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, caso em que o valor será lido do ambiente do cliente 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"
Substitui 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 uma das formas, um valor de -1 informa ao Blaze para usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs padrão: "false"
Se for "true", 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 ProGuard ProgramJar 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 em C++ serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_inmemory_jdeps_files padrão: "true"
Se ativados, os arquivos de dependência (.jdeps) gerados de compilações Java serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_retain_test_configuration_across_testonly padrão: "false"
Quando ativada, a flag --trim_test_configuration não vai remover a configuração de teste para regras marcadas como testonly=1. Isso reduz problemas de conflito de ações quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for "false".
Tags: loading_and_analysis, loses_incremental_state, experimental
--[no]experimental_starlark_cc_import padrão: "false"
Se ativada, a versão Starlark de cc_import poderá ser usada.
Tags: loading_and_analysis, experimental
--[no]experimental_unsupported_and_brittle_include_scanning padrão: "false"
Se as entradas devem ser restritas à compilação C/C++ analisando linhas #include de 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. Em particular, 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 flag que forem enviados serão encerrados.
Tags: loading_and_analysis, execution, changes_inputs, experimental
--[no]incremental_dexing padrão: "true"
Faz a maior parte do trabalho de dexagem 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 reduzir o conjunto de entradas transmitidas para 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çalho estiver ativado para a cadeia de ferramentas).
Tags: execution
--[no]trim_test_configuration padrão: "true"
Quando ativadas, as opções relacionadas a testes 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 a testes 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 detalhe, o formato ou o local do registro em log:
Padrão de --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
Imprime informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação a tipos de cadeia de ferramentas e destinos específicos para ver qual depurar. É possível separar várias expressões regulares com vírgulas, e cada uma delas é verificada separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de toolchain.
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:
--flag_alias=<a 'name=value' flag alias> vários usos 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 arquivos de execução de destinos Python. Precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (o 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 for 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 Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o symlink 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 recomendamos ativar `--incompatible_py3_is_default`. Tags do
: affects_outputs, incompatible_change
--[no]incompatible_py3_is_default padrão: "true"
Se for verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão usar PY3 em vez de PY2 por padrão. Se você definir essa flag, também recomendamos definir `--incompatible_py2_outputs_are_suffixed`. Tags do
: loading_and_analysis, affects_outputs, incompatible_change
--[no]incompatible_use_python_toolchains padrão: "true"
Se definido como "true", as regras executáveis do Python nativo vão usar o ambiente de execução do Python especificado pela cadeia 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 da versão principal do Python, `PY2` ou `PY3`. Isso é substituído por destinos `py_binary` e `py_test`, mesmo que eles não especifiquem uma versão explicitamente. Portanto, geralmente não há muito motivo para fornecer essa flag.
Tags: loading_and_analysis, affects_outputs
Opções diversas, não categorizadas de outra forma.:
--[no]cache_test_results [-t] padrão: "auto"
Se definido como "auto", o Bazel vai executar um teste novamente se e somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste forem solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "yes", o Bazel armazena em cache todos os resultados de testes, 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 for "true", o Blaze vai cancelar os testes em execução simultânea 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 for "true", o Bazel vai buscar o diretório inteiro de dados de cobertura 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 for 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"
Se é necessário gerar o mapa de cabeçalho J2ObjC em paralelo à transcompilação do J2ObjC.
Tags: experimental
--[no]experimental_j2objc_shorter_header_path padrão: "false"
Se a geração deve usar um caminho de cabeçalho mais curto ("_ios" em vez de "_j2objc").
Tags: affects_outputs, experimental
--experimental_java_classpath=<off, javabuilder or bazel> padrão: "javabuilder"
Ativa caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java padrão: "false"
No-op, mantido apenas para compatibilidade com versões anteriores
Tags: affects_outputs, experimental
--[no]experimental_run_android_lint_on_java_rules padrão: "false"
Se as fontes java_* devem 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 obter acidentalmente das dependências do TestRunner. No momento, só funciona para bazel.
--host_java_launcher=<a build target label> padrão: consulte a descrição
O inicializador Java usado por ferramentas executadas durante um build.
--host_javacopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o javac ao criar ferramentas executadas durante um build.
--host_jvmopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a VM Java ao criar ferramentas 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 for verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de testes não indicar que oferece suporte à fragmentação ao tocar no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for "false", um executor de testes que não oferece suporte ao sharding vai fazer com que todos os testes sejam executados em cada fragmento.
Tags: incompatible_change
--[no]incompatible_exclusive_test_sandboxed padrão: "true"
Se for "true", os testes exclusivos serão executados com a estratégia em sandbox. Adicione a tag "local" para forçar uma execução de teste exclusiva no local
Tags: incompatible_change
--[no]incompatible_strict_action_env padrão: "false"
Se for "true", o Bazel usará um ambiente com um valor estático para PATH e não vai herdar LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente, mas observe que 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
Outras opções a serem transmitidas para a 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 -test_output=streamed.
Expansão:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps padrão: "true"
Gere informações de dependência (por enquanto, classpath de tempo de compilação) por destino Java.
--[no]java_header_compilation padrão: "true"
Compile ijars diretamente da origem.
--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 inicializador 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.
Padrão de --java_runtime_version=<a string>: "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.
--jvmopt=<a string> vários usos 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 dexing sem sharding.
--plugin=<a build target label> vários usos são acumulados
Plug-ins a serem usados no build. No momento, funciona com java_plugin.
--proguard_top=<a build target label> padrão: consulte a descrição
Especifica qual versão do ProGuard usar para remoção de código ao criar um binário Java.
--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"
O rótulo do proto-compilador.
Tags: affects_outputs, loading_and_analysis
--[no]proto_profile padrão: "true"
Se profile_path deve ser transmitido ao 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 (o padrão), vai inferir o caminho de --fdo_optimize.
Tags: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> default: "@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> default: "@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> default: "@bazel_tools//tools/proto:javalite_toolchain"
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags: affects_outputs, loading_and_analysis
--protocopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador protobuf.
Tags: affects_outputs
--[no]runs_per_test_detects_flakes padrão: "false"
Se for "true", qualquer fragmento em que pelo menos uma execução/tentativa seja aprovada e pelo menos uma execução/tentativa falhe vai receber 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 não estiver definido, 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 dos dois estiver definido, o Bazel usará um caminho padrão codificado, 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). Usar um shell incompatível com bash pode causar falhas de build ou de tempo de execução dos binários gerados.
Tags: loading_and_analysis
--test_arg=<a string> vários usos são acumulados
Especifica outras opções e argumentos que devem ser transmitidos ao 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 a ser encaminhado para a estrutura de teste. Usado para limitar os testes executados. Isso não afeta quais destinos são criados.
--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 testes. O executor de testes 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 fragmentação de testes: "explicit" para usar a fragmentação somente se o atributo "shard_count" BUILD estiver presente. "disabled" para nunca usar o sharding de teste. "forced=k" para forçar "k" fragmentos para teste, independente do atributo "shard_count" BUILD.
--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 resulta 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"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, o formato ou o local do registro:
Padrão de --help_verbosity=<long, medium or short>: "medium"
Selecione o nível de detalhe do comando de ajuda.
Tags: terminal_output
--long [-l]
Mostra a descrição completa de cada opção, em vez de apenas o nome.
Expande para:
  --help_verbosity=long

Tags: terminal_output
--short
Mostre apenas os nomes das opções, não os tipos ou significados.
Expansão:
  --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"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, 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"
Nenhuma operação.
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:
Padrão de --mode=<classic, classic_internal_test_do_not_use or skylark>: "skylark"
Flag descontinuada sem efeito. Apenas o modo Skylark ainda é compatível.
Tags: loading_and_analysis, execution, incompatible_change
Opções que configuram a cadeia de ferramentas usada 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"
Se uma instalação incremental deve ser feita. Se for verdadeiro, tente evitar trabalho extra desnecessário lendo o estado do dispositivo em que o código será instalado e usando essas informações para evitar trabalho desnecessário. Se for "false" (padrão), sempre faça uma instalação completa.
Tags: loading_and_analysis
--[no]split_apks padrão: "false"
Se é necessário usar APKs divididos para instalar e atualizar o aplicativo no dispositivo. Funciona apenas com dispositivos Marshmallow ou mais recentes
Tags: loading_and_analysis, affects_outputs
Opções que permitem ao usuário configurar a saída pretendida, afetando o valor dela, e não a existência:
--adb_arg=<a string> vários usos 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
Se aguardar o depurador antes de iniciar o app.
Expande 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: "NO"
Como o app deve 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
Se o app deve 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"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, o formato ou o local do registro:
--incremental_install_verbosity=<a string> padrão: ""
O nível de detalhe para a instalação incremental. Defina como 1 para 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"), opcionalmente seguida 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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
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>"
Especifique um módulo em relação ao qual os repositórios de destino especificados serão interpretados.
Tags: terminal_output
Padrão de --charset=<utf8 or ascii>: "utf8"
Escolhe o conjunto de caracteres a ser usado na árvore. Isso só afeta 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"
Aponta ciclos de dependência dentro da árvore mostrada, 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. Já para "deps" e "explain", o padrão é 1 (mostra apenas as dependências diretas da raiz, além das folhas de destino e dos elementos pai delas).
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 flags respectivas 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
Padrão de --extension_info=<hidden, usages, repos or all>: "hidden"
Especifique o nível de detalhes sobre os usos da extensão que serão incluídos no resultado da consulta. "Usos" 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: ""
Especifique 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ências será exibida. Confira a descrição de cada consulta para saber a semântica exata. O padrão é <root>.
Tags: terminal_output
--[no]include_builtin padrão: "false"
Inclui módulos integrados no gráfico de dependências. Desativado por padrão porque é bastante ruidoso.
Tags: terminal_output
--[no]include_unused padrão: "false"
As consultas também vão considerar e mostrar os módulos não utilizados, que não estão presentes no gráfico de resolução de módulos após a seleção (devido à seleção de versão mínima ou às 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 vão mostrar o motivo pelo qual os módulos foram resolvidos para a versão atual (se houver mudanças). O padrão é "true" apenas para a consulta de explicação.
Tags: terminal_output
Opções diversas, não categorizadas de outra forma:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, faz com que o Bazel imprima mensagens "Carregando pacote:".

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"
Nenhuma operação.
Tags: loading_and_analysis
Opções diversas, não categorizadas de outra forma.:
--print_action_mnemonics=<a string> vários usos são acumulados
Lista os mnemônicos para filtrar os dados de print_action. Se deixado em branco, não ocorre filtragem.

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 o destino com falha e aqueles que dependem dele não possam ser analisados, outros pré-requisitos desses destinos 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"), opcionalmente seguida 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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
Tags: loading_and_analysis
Opções relacionadas à saída e à semântica da consulta:
--aspect_deps=<off, conservative or precise> padrão: "conservative"
Como resolver dependências de aspectos quando o formato de saída é um dos seguintes: {xml,proto,record}. "off" significa que nenhuma dependência de aspecto é resolvida. "conservative" (o padrão) significa que todas as dependências de aspecto declaradas são adicionadas, independente de terem recebido a classe de regra de dependências diretas. "precise" significa que apenas os aspectos possivelmente ativos são adicionados, considerando a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar uma única meta, o que o torna mais lento do que os outros modos. Além disso, mesmo o modo preciso não é completamente preciso: a decisão de calcular um aspecto é tomada na fase de análise, que não é executada durante "bazel query".
Tags: build_file_semantics
--[no]consistent_labels padrão: "false"
Se ativado, todo comando de consulta vai emitir rótulos como se a função <code>str</code> do Starlark fosse aplicada a uma instância <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órios aparentes (em relação 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 por aspectos devem ser 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 for 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 só é aplicável a --output=graph.
Tags: terminal_output
--[no]graph:factored padrão: "true"
Se for verdadeiro, o gráfico será emitido "fatorado", ou seja, nós topologicamente equivalentes serão mesclados e seus rótulos concatenados. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--graph:node_limit=<an integer> padrão: "512"
O comprimento máximo da string de rótulo para um nó de gráfico na saída. Rótulos mais longos serão truncados. -1 significa que não haverá truncamento. Essa opção só é aplicável a --output=graph.
Tags: terminal_output
--[no]implicit_deps padrão: "true"
Se ativadas, 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 é aquela que 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 por aspectos devem ser 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 estiver definida, vai classificar a saída --order_output=auto em ordem lexicográfica.
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", a barra dupla inicial "//" não será omitida.
Tags: terminal_output, incompatible_change
--[no]infer_universe_scope padrão: "false"
Se definido e --universe_scope não estiver definido, um valor de --universe_scope será inferido como a lista de padrões de destino exclusivos na expressão de 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 apenas se souber o que está fazendo. Acesse https://bazel.build/reference/query#sky-query para ver 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" (ou seja, não "cquery"). Tags do
: loading_and_analysis
--[no]line_terminator_null padrão: "false"
Indica se cada formato é encerrado com \0 em vez de uma 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 atributo "nodep" é "visibility". 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
Mostra os resultados em ordem de dependência (padrão) ou sem ordem. A saída não ordenada é mais rápida, mas só é compatível quando --output não é minrank, maxrank ou graph.
Expande para:
  --order_output=no

Tags: terminal_output
--null
Indica se cada formato é encerrado com \0 em vez de uma nova linha.
Expande para:
  --line_terminator_null=true

Tags: terminal_output
--order_output=<no, deps, auto or full> padrão: "auto"
Gere os resultados sem ordem (no), com ordem de dependência (deps) ou totalmente ordenados (full). O padrão é "auto", o que significa que os resultados são gerados com ordenação por dependência ou completa, dependendo do formatador de saída (por dependência para proto, minrank, maxrank e gráfico, completa para todos os outros). Quando a saída está 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
Mostra os resultados em ordem de dependência (padrão) ou sem ordem. A saída não ordenada é mais rápida, mas só é compatível quando --output não é minrank, maxrank ou graph.
Expande para:
  --order_output=auto

Tags: terminal_output
Padrão de --output=<a string>: "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
--[no]proto:default_values padrão: "true"
Se for "true", os atributos cujo valor não estiver especificado explicitamente no arquivo BUILD serão incluídos. Caso contrário, eles serão omitidos. Essa opção se aplica 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 ativados, os atributos configuráveis criados por select() serão simplificados. Para tipos de lista, a representação simplificada é uma lista que contém cada valor do mapa de seleção exatamente uma vez. Os tipos escalares são nivelados como nulos.
Tags: build_file_semantics
--[no]proto:include_attribute_source_aspects padrão: "false"
Preencha o campo proto source_aspect_name de cada atributo com o aspecto de origem de que o atributo veio (string vazia se não veio de nenhum).
Tags: terminal_output
--[no]proto:include_synthetic_attribute_hash padrão: "false"
Se o atributo $internal_attr_hash deve 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 exige que a pilha esteja presente.
Tags: terminal_output
--[no]proto:locations padrão: "true"
Se é necessário gerar informações de localização na saída proto.
Tags: terminal_output
Padrão de --proto:output_rule_attrs=<comma-separated list of options>: "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 e, para a primeira regra com um determinado "rule_class_key", preencha também o campo proto "rule_class_info". O campo "rule_class_key" identifica exclusivamente uma classe de regra, e o campo "rule_class_info" é uma definição de API de classe de regra no formato Stardoc.
Tags: terminal_output
--[no]proto:rule_inputs_and_outputs padrão: "true"
Se os campos "rule_input" e "rule_output" devem ser preenchidos ou não.
Tags: terminal_output
--query_file=<a string> padrão: ""
Se definido, a consulta vai ler o 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 for "true", o local dos arquivos BUILD nas saídas XML e proto será relativo. Por padrão, a saída de local é um caminho absoluto e não é consistente em todas 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 for "true", a expressão tests() vai gerar um erro se encontrar uma test_suite que contenha destinos que não são de teste.
Tags: build_file_semantics, eagerness_to_exit
--[no]tool_deps padrão: "true"
Consulta: se desativada, as dependências da "configuração de execução" não serão incluídas no gráfico de dependências em que a consulta opera. Uma aresta de dependência de "configuração de execução", como a de qualquer regra "proto_library" para o compilador de protocolo, geralmente aponta para uma ferramenta executada durante a build, em vez de uma parte do mesmo programa "target". Cquery: se desativado, filtra todos os destinos configurados que cruzam uma transição de execução do destino de nível superior que descobriu esse destino configurado. Isso significa que, se o destino de nível superior estiver na configuração de destino, somente os destinos configurados que também estiverem na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração de execução, somente os destinos configurados para execução serão retornados. Essa opção NÃO exclui toolchains resolvidas.
Tags: build_file_semantics
--universe_scope=<comma-separated list of options> padrão: ""
Um conjunto de padrões de segmentação (aditivos e subtrativos) separados por vírgulas. A consulta pode ser realizada no universo definido pelo fechamento transitivo das metas especificadas. Essa opção é usada para os comandos "query" e "cquery". Para cquery, a entrada dessa opção são os destinos em que todas as respostas são criadas. Portanto, essa opção pode afetar 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 da expressão de consulta. Observação: para cquery, não especificar essa opção pode fazer com que o build seja interrompido se os destinos analisados da 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 for "true", os atributos de regra cujo valor não estiver 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 for "true", a saída XML vai conter números de linha. Desativar essa opção pode facilitar a leitura das diferenças. Essa opção só é aplicável a --output=xml.
Tags: terminal_output
Opções que afetam a verbosidade, o formato ou o local do registro em log:
--experimental_repository_resolved_file=<a string> padrão: ""
Se não estiver vazio, grave um valor Starlark com as informações resolvidas de todas as regras de repositório Starlark executadas.
Tags: affects_outputs
Opções diversas, não categorizadas de outra forma:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, 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 for "true", inclui caminhos para substituir em ExecRequest e tornar os caminhos resultantes portáteis.
Tags: affects_outputs
--[no]run padrão: "true"
Se for "false", pule a execução da linha de comando criada para o destino de build. Essa flag é ignorada em todos os builds --script_path.
Tags: affects_outputs
--run_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: affects_outputs
Opções que permitem ao usuário configurar a saída pretendida, afetando o valor dela, e não a existência:
--script_path=<a path> padrão: consulte a descrição
Se definido, grava um script shell no arquivo especificado que invoca o destino. Se essa opção for definida, o destino não será executado pelo bazel. Use "bazel run --script_path=foo //foo && ./foo" para invocar o destino "//foo". Isso difere 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 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"
Nenhuma operação.
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 for diferente de zero, o encerramento só vai desligar o servidor 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 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"
Nenhuma operação.
Tags: loading_and_analysis

Opções de sincronização

Opções que controlam a execução do build:
--[no]configure padrão: "False"
Sincronize apenas repositórios 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 o destino com falha e aqueles que dependem dele não possam ser analisados, outros pré-requisitos desses destinos 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"), opcionalmente seguida 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
--only=<a string> vários usos são acumulados
Se essa opção for fornecida, sincronize apenas os repositórios especificados com ela. Ainda considera tudo (ou tudo semelhante a "configure", se "--configure" for fornecido) desatualizado.
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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, o formato ou o local do registro:
--experimental_repository_resolved_file=<a string> padrão: ""
Se não estiver vazio, grave um valor Starlark com as informações resolvidas de todas as regras de repositório Starlark executadas.
Tags: affects_outputs
Opções diversas, não categorizadas de outra forma:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, 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"
Nenhuma operação.
Tags: loading_and_analysis
Opções que afetam a verbosidade, o formato ou o local do registro:
--[no]print_relative_test_log_paths padrão: "false"
Se for verdadeiro, ao imprimir o caminho para um registro de teste, use o caminho relativo que usa o symlink de conveniência "testlogs". Observação: uma invocação subsequente de "build"/"test"/etc. com uma configuração diferente pode mudar o destino desse link simbólico, tornando o caminho impresso anteriormente inútil.
Tags: affects_outputs
--[no]test_verbose_timeout_warnings padrão: "false"
Se for "true", vai imprimir avisos extras quando o tempo real de execução do teste não corresponder ao tempo limite definido por ele (implícito ou explícito).
Tags: affects_outputs
--[no]verbose_test_summary padrão: "true"
Se for verdadeiro, imprima mais informações (tempo, número de execuções com falha etc.) no resumo do teste.
Tags: affects_outputs

Opções de 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 o destino com falha e aqueles que dependem dele não possam ser analisados, outros pré-requisitos desses destinos 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"), opcionalmente seguida 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 não terá efeito. Caso contrário, se essa flag for "false", qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa flag for "true", "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 for "true", aplique as restrições de visibilidade de config_setting. Se for "false", todas as config_setting serão visíveis para todos os destinos. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_use_plus_in_repo_names padrão: "true"
Nenhuma operação.
Tags: loading_and_analysis
Opções relacionadas à saída e à semântica do Bzlmod:
--repo=<a string> vários usos 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.:
--deleted_packages=<comma-separated list of package names> vários usos 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 poderá reclamar se encontrar um rótulo "//x:y/z" se ele ainda for fornecido por outra entrada 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 não houver nenhuma, o comando vai falhar.
--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 envolvido. Se for omitido ou estiver vazio, o padrão será a saída de "bazel info default-package-path".
--[no]show_loading_progress padrão: "true"
Se ativada, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções que controlam a execução do build:
Se é necessário 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 aar permanente usando workers.
Tags: execution, experimental
--[no]experimental_remotable_source_manifests padrão: "false"
Se as ações do manifesto de origem podem ser executadas remotamente
Tags: loading_and_analysis, execution, experimental
--[no]experimental_split_coverage_postprocessing padrão: "false"
Se for "true", o Bazel vai executar o pós-processamento de cobertura para o 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 regulares. Eles não vão percorrer diretórios nem serão sensíveis a symlinks.
Tags: execution, experimental
--[no]incompatible_modify_execution_info_additive padrão: "false"
Quando ativada, a transmissão de várias flags --modify_execution_info é cumulativa. Quando desativada, apenas a última flag é considerada.
Tags: execution, affects_outputs, loading_and_analysis, incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> vários usos são acumulados
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico dela. 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=[+-]key,regex=[+-]key,...". 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 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 dessugar do Android usando workers.
Expande 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 persistentes do Android usando workers.
Expansão:--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 e multiplexadas de dex e dessugar do Android 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 persistente 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
Ativa ferramentas persistentes e multiplexadas do Android (dexing, dessugarização, processamento de recursos).
Expande 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 for "true", 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 o combinador de manifestos a ser usado para regras android_binary. Flag para ajudar na transição da combinação legada para a combinação de manifestos do Android.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--android_platforms=<a build target label> padrão: ""
Define as plataformas usadas pelas segmentações android_binary. Se várias plataformas forem especificadas, o binário será um APK gordo, 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> default: "@bazel_tools//tools/cpp:toolchain"
O rótulo do pacote crosstool a ser usado em regras do Apple e Objc e suas dependências.
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> default: "@bazel_tools//tools/test:lcov_merger"
Localização do binário usado para pós-processar relatórios de cobertura bruta. 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> default: "@bazel_tools//tools/test:coverage_report_generator"
Localização 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> default: "@bazel_tools//tools/test:coverage_support"
Localização dos arquivos de suporte necessários nas entradas de todas as ações de teste que coletam cobertura de 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 de malloc personalizada. Essa configuração substitui os atributos malloc nas regras de build.
Tags: changes_inputs, affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> vários usos são acumulados
Lista de expressões regulares separadas por vírgulas, cada uma prefixada opcionalmente por - (expressão negativa), atribuída (=) a uma lista de destinos de valor de restrição separados por vírgulas. Se um destino não 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 contenha "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 todas as ações do Xcode. Se a versão do Xcode tiver um rótulo hifenizado, 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 for "true", use o Xcode mais recente disponível localmente e remotamente. Se for "false" ou se não houver versões disponíveis em comum, use a versão local do Xcode selecionada com xcode-select.
Tags: loses_incremental_state, experimental
--extra_execution_platforms=<comma-separated list of options> padrão: ""
As plataformas disponíveis como plataformas de execução para realizar ações. As plataformas podem ser especificadas por segmentação exata ou como um padrão de segmentação. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores vão substituir as configurações de flag anteriores.
Tags: execution
--extra_toolchains=<comma-separated list of options> vários usos são acumulados
As regras da cadeia de ferramentas a serem consideradas durante a resolução da cadeia de ferramentas. As toolchains podem ser especificadas por destino exato ou como um padrão de destino. Esses conjuntos de ferramentas serão considerados antes daqueles 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 crosstool, e quase nunca é necessário substituir esse valor.
Tags: action_command_lines, affects_outputs
--host_compiler=<a string> padrão: consulte a descrição
Flag sem operação. Será removido em uma versão futura.
Tags: loading_and_analysis, execution
--host_grte_top=<a label> padrão: consulte a descrição
Se especificada, essa configuração substitui o diretório de nível superior da libc (--grte_top) para a configuração de execução.
Tags: action_command_lines, affects_outputs
--host_platform=<a build target label> default: "@bazel_tools//tools:host_platform"
O rótulo de uma regra de plataforma que descreve o sistema 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 estiver desativado, ele vai criar "//:runner" na configuração de destino. O Bazel executa testes em máquinas de execução, então o primeiro é mais correto. Isso não afeta "bazel run", que sempre cria "`--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 for "true", o Bazel não vai ativar os recursos "host" e "nonhost" na cadeia de ferramentas do 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 da cadeia de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativas)
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_remove_legacy_whole_archive padrão: "true"
Se for "true", o Bazel não vai vincular dependências de biblioteca como um arquivo inteiro 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 for verdadeiro, a ação de remoção para executáveis usará a flag -x, que não interrompe a resolução dinâmica de símbolos.
Tags: action_command_lines, incompatible_change
--[no]interface_shared_objects padrão: "true"
Use objetos compartilhados de interface se o conjunto de ferramentas for compatível. Todas as toolchains ELF são compatíveis com 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 do iOS a ser usada para criar aplicativos iOS. Se não for especificado, 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, 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 que sua compilação segmenta.
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 Python invocado para executar destinos 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 rótulo de um py_runtime que representa o interpretador Python invocado para executar destinos 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 desse sistema operacional. Se não for especificado, usará a versão padrão do SDK do 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, 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 fornecida 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> default: "@bazel_tools//tools/cpp:host_xcodes"
O rótulo da regra xcode_config a ser usada para selecionar a versão do Xcode na configuração de build.
Tags: loses_incremental_state, loading_and_analysis
Opções que controlam a saída do comando:
--[no]apple_generate_dsym padrão: "false"
Se é necessário gerar arquivos de símbolos de depuração (.dSYM).
Tags: affects_outputs, action_command_lines
Se for verdadeiro, vai criar florestas de symlink de runfiles para todos os destinos. Se for "false", grave-os apenas quando exigido por uma ação, teste ou comando de execução local.
Tags: affects_outputs
--[no]build_runfile_manifests padrão: "true"
Se for "true", grava manifestos de runfiles para todas as metas. Se for "false", omita-os. Os testes locais não serão executados quando for "false".
Tags: affects_outputs
--[no]build_test_dwp padrão: "false"
Se ativado, ao criar testes em C++ de forma estática e com fusã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
Padrão de --cc_proto_library_source_suffixes=<comma-separated set of options>: ".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"
Executa ações extras para versões alternativas da 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 fissão para compilações e vinculações 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 for verdadeiro, as regras nativas vão adicionar <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 for "true", vai criar florestas de symlink 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 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 de 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 dela, e não a existência:
--action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções 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"
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso só é usado com a vinculação de dados v2. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--[no]android_databinding_use_v3_4_args padrão: "true"
Use a vinculação de dados do Android v2 com o argumento 3.4.0. Essa flag não faz nada.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
--android_dynamic_mode=<off, default or fully> padrão: "off"
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 a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo estático.
Tags: affects_outputs, loading_and_analysis
Padrão de --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "alphabetical"
Define a ordem dos manifestos transmitidos à ferramenta de mescla 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 dela.
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"
Crie um zip executável do Python. Ativado no Windows e desativado em outras plataformas.
Tags: affects_outputs
--catalyst_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 instrumentação off-line sempre que possível) e coletar informações de cobertura durante os testes. Apenas os destinos que correspondem a --instrumentation_filter serão afetados. Normalmente, essa opção não deve ser especificada diretamente. Em vez disso, use o comando "bazel coverage".
Tags: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] padrão: "fastbuild"
Especifique o modo em que o binário será criado. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--conlyopt=<a string> vários usos são acumulados
Opção adicional para transmitir ao gcc ao compilar arquivos de origem C.
Tags: action_command_lines, affects_outputs
--copt=<a string> vários usos são acumulados
Outras opções 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 informações de 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
Gere 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 despejados durante a execução.
Tags: affects_outputs
--cs_fdo_profile=<a build target label> padrão: consulte a descrição
O cs_fdo_profile que representa o perfil sensível ao contexto a ser usado para otimização.
Tags: affects_outputs
--cxxopt=<a string> vários usos são acumulados
Opção extra para transmitir ao gcc ao compilar arquivos de origem C++.
Tags: action_command_lines, affects_outputs
--define=<a 'name=value' assignment> vários usos são acumulados
Cada opção "--define" especifica uma atribuição para uma variável de build. Em caso de vários valores para uma variável, o último vence.
Tags: changes_inputs, affects_outputs
--dynamic_mode=<off, default or fully> padrão: "default"
Determina se os binários C++ serão vinculados dinamicamente. "default" significa que o Bazel vai escolher se a vinculação será dinâmica. "Totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas principalmente no modo 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 a otimização do propeller 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 symlink de runfiles. Por padrão, ela fica desativada no Windows e ativada em outras plataformas.
Tags: affects_outputs
--experimental_action_listener=<a build target label> vários usos são acumulados
Obsoleto, substituído por "aspectos". Use action_listener para anexar uma extra_action a 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 a vinculação de dados do Android v2. Essa flag não faz nada.
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 rex tool to rewrite dex files
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 do compilador objc fastbuild.
Tags: action_command_lines
--[no]experimental_omitfp padrão: "false"
Se for verdadeiro, use libunwind para desenrolar 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: "off"
Qual modelo usar para onde as regras da árvore de saída gravam as saídas, principalmente para builds multiplataforma / multiconfiguração. Esse recurso é altamente experimental. Consulte https://github.com/bazelbuild/bazel/issues/6526 para mais detalhes. As ações do Starlark podem ativar o mapeamento de caminhos adicionando a chave "supports-path-mapping" ao dicionário "execution_requirements".
Tags: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> vários usos 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. Usado somente 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 for "true", um nome abreviado para a plataforma de destino será usado no nome do diretório de saída em vez da CPU. O esquema exato é experimental e está 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 um nome abreviado para a plataforma atual foi 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 inclusão de carimbos está desativada.
Tags: affects_outputs, experimental
--[no]experimental_use_llvm_covmap padrão: "false"
Se especificado, o Bazel vai gerar informações de mapa de cobertura llvm-cov em vez de gcov quando 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. Por isso, recomendamos 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
Gere binários com a instrumentação do FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão despejados durante a execução.
Tags: affects_outputs
--fdo_optimize=<a string> padrão: consulte a descrição
Use informações de perfil da FDO para otimizar a compilação. Especifique o nome de um arquivo zip que contenha 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
--features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de destino. Especificar -<recurso> desativa o recurso. Recursos negativos sempre substituem os positivos. Consulte também --host_features
Tags: changes_inputs, affects_outputs
--[no]force_pic padrão: "false"
Se ativada, todas as compilações em C++ produzem código independente de posição ("-fPIC"), as vinculações preferem bibliotecas pré-criadas PIC em vez de bibliotecas não PIC, e as vinculações produzem executáveis independentes de posição ("-pie").
Tags: loading_and_analysis, affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part> vários usos são acumulados
Especifica o conjunto de variáveis de ambiente disponíveis para ações com configurações de execução. As variáveis podem ser especificadas por nome, caso em que o valor será extraído do ambiente de invocação, ou pelo par nome=valor, 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, a mais recente vence. Para variáveis diferentes, as opções são acumuladas.
Tags: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> padrão: "opt"
Especifique o modo em que as ferramentas usadas durante a criação serão criadas. Valores: "fastbuild", "dbg", "opt".
Tags: affects_outputs, action_command_lines
--host_conlyopt=<a string> vários usos são acumulados
Opção extra para transmitir ao compilador C ao compilar arquivos de origem C (mas não C++) nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_copt=<a string> vários usos são acumulados
Outras opções 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 do host.
Tags: changes_inputs, affects_outputs
--host_cxxopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador C++ para ferramentas criadas nas configurações de execução.
Tags: action_command_lines, affects_outputs
--host_features=<a string> vários usos são acumulados
Os recursos especificados serão ativados ou desativados por padrão para destinos criados na configuração de execução. Especificar -<recurso> desativa o recurso. 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
--host_linkopt=<a string> vários usos são acumulados
Opção extra 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 de host. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações de execuçã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ões regulares 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 @. Somente 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 cadeia de ferramentas usada 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 for verdadeiro, o diretório genfiles será incorporado ao diretório bin.
Tags: affects_outputs, incompatible_change
--[no]instrument_test_targets padrão: "false"
Quando a cobertura está ativada, especifica se é preciso considerar a instrumentação de regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. 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 especificado baseado em regex são instrumentadas. As regras com o prefixo "-" são excluídas. Somente 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, usará "ios_sdk_version".
Tags: loses_incremental_state
--ios_multi_cpus=<comma-separated list of options> vários usos 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 mais detalhes. Quando ativada, 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
--linkopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para o gcc ao vincular.
Tags: action_command_lines, affects_outputs
--ltobackendopt=<a string> vários usos são acumulados
Opção adicional para transmitir à etapa de back-end do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--ltoindexopt=<a string> vários usos são acumulados
Opção adicional a ser transmitida para a etapa de indexação do LTO (em --features=thin_lto).
Tags: action_command_lines, affects_outputs
--macos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do macOS para destinos. Se não for especificado, usará "macos_sdk_version".
Tags: loses_incremental_state
--memprof_profile=<a build target label> padrão: consulte a descrição
Use o perfil memprof.
Tags: affects_outputs
--[no]objc_debug_with_GLIBCXX padrão: "false"
Se definido e o modo de compilação for "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags: action_command_lines
--[no]objc_enable_binary_stripping padrão: "false"
Se é necessário realizar a remoção de símbolos e códigos mortos em binários vinculados. A remoção de binários será realizada se esta flag e --compilation_mode=opt forem especificadas.
Tags: action_command_lines
--objccopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o gcc ao compilar arquivos de origem Objective-C/C++.
Tags: action_command_lines
--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> vários usos são acumulados
Outras opções 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ões regulares 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 @. Somente 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 gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags: action_command_lines, affects_outputs
--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> vários usos são acumulados
Outras opções para transmitir seletivamente ao back-end do 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, e 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 @. Somente 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 LTO de todos os arquivos o 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",)Talvez seja necessário adicionar uma diretiva exports_files ao pacote correspondente para tornar esses arquivos visíveis ao 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 para Propeller.
Tags: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> padrão: consulte a descrição
Nome do caminho absoluto do arquivo ld_profile para builds otimizados para 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" e "//package:target --options".
Tags: action_command_lines
--[no]share_native_deps padrão: "true"
Se for "true", 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"
Adicione carimbos aos 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
Padrão de --strip=<always, sometimes or never>: "sometimes"
Especifica se os binários e as bibliotecas compartilhadas devem ser removidos (usando "-Wl,--strip-debug"). O valor padrão "sometimes" significa remover se --compilation_mode=fastbuild.
Tags: affects_outputs
--stripopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a remoção ao gerar um binário "<name>.stripped".
Tags: action_command_lines, affects_outputs
--tvos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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, usará "tvos_sdk_version".
Tags: loses_incremental_state
--visionos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para criar binários do Apple visionOS.
Tags: loses_incremental_state, loading_and_analysis
--watchos_cpus=<comma-separated list of options> vários usos são acumulados
Lista separada por vírgulas de arquiteturas para 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 compatível do watchOS para simuladores e dispositivos de destino. Se não for especificado, usará "watchos_sdk_version".
Tags: loses_incremental_state
--xbinary_fdo=<a build target label> padrão: consulte a descrição
Use informações de perfil do XbinaryFDO para otimizar a compilação. Especifique o nome do perfil 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 rigidez com que o Bazel aplica entradas de build válidas (definições de regras, combinações de flags 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 dos destinos que estão sendo criados. 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 nas dependências de destino serão rebaixados para avisos.
Tags: build_file_semantics
--[no]desugar_for_android padrão: "true"
Se o bytecode Java 8 deve ser simplificado antes da conversão para DEX.
Tags: affects_outputs, loading_and_analysis, loses_incremental_state
--[no]desugar_java8_libs padrão: "false"
Se as bibliotecas Java 8 compatíveis devem 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"
Se é necessário verificar novamente a dessugarização correta 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
No-op, 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 opção 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 for 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 testonly para destinos de pré-requisito que são arquivos de saída pesquisando 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 a implementações de cadeia de ferramentas.
Tags: build_file_semantics, incompatible_change
--[no]incompatible_disable_native_android_rules padrão: "false"
Se ativada, 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"
No-op. Mantido aqui para compatibilidade com versões anteriores.
Tags: eagerness_to_exit, incompatible_change
--[no]incompatible_python_disable_py2 padrão: "true"
Se for verdadeiro, usar as configurações do Python 2 vai causar um erro. Isso inclui python_version=PY2, srcs_version=PY2 e srcs_version=PY2ONLY. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/15684.
Tags: loading_and_analysis, incompatible_change
--[no]one_version_enforcement_on_java_tests padrão: "true"
Quando ativada e com experimental_one_version_enforcement definido como um valor diferente de NONE, impõe uma versão em destinos java_test. Essa flag pode ser desativada para melhorar a performance do teste incremental, mas isso pode fazer com que possíveis violações de uma versão sejam perdidas.
Tags: loading_and_analysis
--python_native_rules_allowlist=<a build target label> padrão: consulte a descrição
Uma lista de permissões (destino 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 cruzam 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 OFF, 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: "off"
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente como exportados todos os destinos usados em "import public".
Tags: build_file_semantics, eagerness_to_exit, incompatible_change
--[no]strict_system_includes padrão: "false"
Se for "true", os cabeçalhos encontrados por caminhos de inclusão do sistema (-isystem) também precisarão ser declarados.
Tags: loading_and_analysis, eagerness_to_exit
--target_environment=<a build target label> vários usos são acumulados
Declara o ambiente de destino desta build. Precisa ser uma referência de rótulo a 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 incluirão 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, será usado o perfil de provisionamento. Pode ser a preferência de identidade do keychain do certificado ou (substring) do nome comum do certificado, conforme a página de manual do 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"
Sem operação, será removido em breve.
Tags: loading_and_analysis, incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes padrão: "false"
Se for "true", não permita os atributos sdk_frameworks e weak_sdk_frameworks em objc_library e objc_import.
Tags: build_file_semantics, incompatible_change
Se for verdadeiro, defina o valor padrão como verdadeiro para 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 devem 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 regem o comportamento do ambiente de teste ou do executor de testes:
--[no]allow_analysis_failures padrão: "false"
Se for "true", uma falha na análise de um destino de regra vai resultar na propagação 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
Padrão de --analysis_testing_deps_limit=<an integer>: "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 for "true", as falhas na ação dex2oat vão interromper o build em vez de executar dex2oat durante o tempo de execução do teste.
Tags: loading_and_analysis, experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> vários usos são acumulados
Substitua a quantidade padrão de recursos 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írgulas 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"
Ative 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 é ignorado para regras ios_test se um dispositivo de destino for especificado na regra.
Tags: test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> vários usos são acumulados
Especifica o número de vezes que cada teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, o teste inteiro será considerado falho. 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 transmitido mais recentemente que corresponde tem precedência. Se nada corresponder, o teste será executado apenas uma vez.
--test_env=<a 'name=value' assignment with an optional value part> vários usos 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, caso em que o valor será lido do ambiente do cliente 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"
Substitui 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 uma das formas, um valor de -1 informa ao Blaze para usar os tempos limite padrão para essa categoria.
--[no]zip_undeclared_test_outputs padrão: "false"
Se for "true", 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 ProGuard ProgramJar 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 em C++ serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_inmemory_jdeps_files padrão: "true"
Se ativados, os arquivos de dependência (.jdeps) gerados de compilações Java serão transmitidos na memória diretamente dos nós de build remoto em vez de serem gravados em disco.
Tags: loading_and_analysis, execution, affects_outputs, experimental
--[no]experimental_retain_test_configuration_across_testonly padrão: "false"
Quando ativada, a flag --trim_test_configuration não vai remover a configuração de teste para regras marcadas como testonly=1. Isso reduz problemas de conflito de ações quando regras que não são de teste dependem de regras cc_test. Não tem efeito se --trim_test_configuration for "false".
Tags: loading_and_analysis, loses_incremental_state, experimental
--[no]experimental_starlark_cc_import padrão: "false"
Se ativada, a versão Starlark de cc_import poderá ser usada.
Tags: loading_and_analysis, experimental
--[no]experimental_unsupported_and_brittle_include_scanning padrão: "false"
Se as entradas devem ser restritas à compilação C/C++ analisando linhas #include de 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. Em particular, 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 flag que forem enviados serão encerrados.
Tags: loading_and_analysis, execution, changes_inputs, experimental
--[no]incremental_dexing padrão: "true"
Faz a maior parte do trabalho de dexagem 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 reduzir o conjunto de entradas transmitidas para 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çalho estiver ativado para a cadeia de ferramentas).
Tags: execution
--[no]trim_test_configuration padrão: "true"
Quando ativadas, as opções relacionadas a testes 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 a testes 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 detalhe, o formato ou o local do registro em log:
Padrão de --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
Imprime informações de depuração durante a resolução da cadeia de ferramentas. A flag usa uma regex, que é verificada em relação a tipos de cadeia de ferramentas e destinos específicos para ver qual depurar. É possível separar várias expressões regulares com vírgulas, e cada uma delas é verificada separadamente. Observação: a saída dessa flag é muito complexa e provavelmente só será útil para especialistas em resolução de toolchain.
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:
--flag_alias=<a 'name=value' flag alias> vários usos 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 arquivos de execução de destinos Python. Precisamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (o 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 for 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 Python 3 vão aparecer em uma raiz sem sufixo relacionado ao Python. Isso significa que o symlink 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 recomendamos ativar `--incompatible_py3_is_default`. Tags do
: affects_outputs, incompatible_change
--[no]incompatible_py3_is_default padrão: "true"
Se for verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") vão usar PY3 em vez de PY2 por padrão. Se você definir essa flag, também recomendamos definir `--incompatible_py2_outputs_are_suffixed`. Tags do
: loading_and_analysis, affects_outputs, incompatible_change
--[no]incompatible_use_python_toolchains padrão: "true"
Se definido como "true", as regras executáveis do Python nativo vão usar o ambiente de execução do Python especificado pela cadeia 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 da versão principal do Python, `PY2` ou `PY3`. Isso é substituído por destinos `py_binary` e `py_test`, mesmo que eles não especifiquem uma versão explicitamente. Portanto, geralmente não há muito motivo para fornecer essa flag.
Tags: loading_and_analysis, affects_outputs
Opções diversas, não categorizadas de outra forma.:
--[no]cache_test_results [-t] padrão: "auto"
Se definido como "auto", o Bazel vai executar um teste novamente se e somente se: (1) o Bazel detectar mudanças no teste ou nas dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste forem solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "yes", o Bazel armazena em cache todos os resultados de testes, 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 for "true", o Blaze vai cancelar os testes em execução simultânea 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 for "true", o Bazel vai buscar o diretório inteiro de dados de cobertura 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 for 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"
Se é necessário gerar o mapa de cabeçalho J2ObjC em paralelo à transcompilação do J2ObjC.
Tags: experimental
--[no]experimental_j2objc_shorter_header_path padrão: "false"
Se a geração deve usar um caminho de cabeçalho mais curto ("_ios" em vez de "_j2objc").
Tags: affects_outputs, experimental
--experimental_java_classpath=<off, javabuilder or bazel> padrão: "javabuilder"
Ativa caminhos de classe reduzidos para compilações Java.
--[no]experimental_limit_android_lint_to_android_constrained_java padrão: "false"
No-op, mantido apenas para compatibilidade com versões anteriores
Tags: affects_outputs, experimental
--[no]experimental_run_android_lint_on_java_rules padrão: "false"
Se as fontes java_* devem 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 obter acidentalmente das dependências do TestRunner. No momento, só funciona para bazel.
--host_java_launcher=<a build target label> padrão: consulte a descrição
O inicializador Java usado por ferramentas executadas durante um build.
--host_javacopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para o javac ao criar ferramentas executadas durante um build.
--host_jvmopt=<a string> vários usos são acumulados
Outras opções a serem transmitidas para a VM Java ao criar ferramentas 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 for verdadeiro, o Bazel vai falhar em um teste fragmentado se o executor de testes não indicar que oferece suporte à fragmentação ao tocar no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se for "false", um executor de testes que não oferece suporte ao sharding vai fazer com que todos os testes sejam executados em cada fragmento.
Tags: incompatible_change
--[no]incompatible_exclusive_test_sandboxed padrão: "true"
Se for "true", os testes exclusivos serão executados com a estratégia em sandbox. Adicione a tag "local" para forçar uma execução de teste exclusiva no local
Tags: incompatible_change
--[no]incompatible_strict_action_env padrão: "false"
Se for "true", o Bazel usará um ambiente com um valor estático para PATH e não vai herdar LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente, mas observe que 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
Outras opções a serem transmitidas para a 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 -test_output=streamed.
Expansão:
  --test_arg=--wrapper_script_flag=--debug
  --test_output=streamed
  --test_strategy=exclusive
  --test_timeout=9999
  --nocache_test_results
--[no]java_deps padrão: "true"
Gere informações de dependência (por enquanto, classpath de tempo de compilação) por destino Java.
--[no]java_header_compilation padrão: "true"
Compile ijars diretamente da origem.
--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 inicializador 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.
Padrão de --java_runtime_version=<a string>: "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.
--jvmopt=<a string> vários usos 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 dexing sem sharding.
--plugin=<a build target label> vários usos são acumulados
Plug-ins a serem usados no build. No momento, funciona com java_plugin.
--proguard_top=<a build target label> padrão: consulte a descrição
Especifica qual versão do ProGuard usar para remoção de código ao criar um binário Java.
--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"
O rótulo do proto-compilador.
Tags: affects_outputs, loading_and_analysis
--[no]proto_profile padrão: "true"
Se profile_path deve ser transmitido ao 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 (o padrão), vai inferir o caminho de --fdo_optimize.
Tags: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> default: "@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> default: "@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> default: "@bazel_tools//tools/proto:javalite_toolchain"
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags: affects_outputs, loading_and_analysis
--protocopt=<a string> vários usos são acumulados
Outras opções para transmitir ao compilador protobuf.
Tags: affects_outputs
--[no]runs_per_test_detects_flakes padrão: "false"
Se for "true", qualquer fragmento em que pelo menos uma execução/tentativa seja aprovada e pelo menos uma execução/tentativa falhe vai receber 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 não estiver definido, 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 dos dois estiver definido, o Bazel usará um caminho padrão codificado, 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). Usar um shell incompatível com bash pode causar falhas de build ou de tempo de execução dos binários gerados.
Tags: loading_and_analysis
--test_arg=<a string> vários usos são acumulados
Especifica outras opções e argumentos que devem ser transmitidos ao 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 a ser encaminhado para a estrutura de teste. Usado para limitar os testes executados. Isso não afeta quais destinos são criados.
--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 testes. O executor de testes 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 fragmentação de testes: "explicit" para usar a fragmentação somente se o atributo "shard_count" BUILD estiver presente. "disabled" para nunca usar o sharding de teste. "forced=k" para forçar "k" fragmentos para teste, independente do atributo "shard_count" BUILD.
--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 resulta 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 dela, e não a existência:
--[no]gnu_format padrão: "false"
Se definido, grave a versão em stdout usando as convenções descritas nos padrões GNU.
Tags: affects_outputs, 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"
Nenhuma operação.
Tags: loading_and_analysis

Tags de efeito da 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 deixa os builds mais lentos. O estado pode ser perdido devido a uma reinicialização do servidor ou à invalidação de uma grande parte do gráfico de dependência.
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 máquina interna do Bazel. Essa tag não significa, por si só, que os artefatos de build foram afetados.
loading_and_analysis Essa opção afeta o carregamento e a análise de dependências, além da criação do gráfico de dependência.
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 troca com outros aspectos de performance, como custo de memória ou CPU.
eagerness_to_exit Essa opção muda a forma como 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 da linha de comando de uma ou mais ações de build.
test_runner Essa opção muda o ambiente do testrunner 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 causa uma mudança interruptiva. Use essa opção para testar se você está pronto para a migração ou ter acesso antecipado ao novo recurso
deprecated O uso dessa opção foi suspenso. Talvez o recurso afetado esteja descontinuado ou outro método de fornecer as informações seja preferível.
immutable Essa opção não pode ser alterada em uma transição.