bazel [<startup options>] <command> [<args>]ou
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Consulte o Guia do usuário para a sintaxe dos padrões de destino.
Sintaxe da opção
As opções podem ser passadas para o Bazel de maneiras diferentes. As opções que exigem um valor podem ser transmitidas com um sinal de igual ou um espaço:
--<option>=<value> --<option> <value>Algumas opções têm um único formato curto de caractere. Nesse caso, o formato curto precisa ser transmitido com um único traço e um espaço.
-<short_form> <value>
As opções booleanas podem ser ativadas da seguinte maneira:
--<option> --<option>=[true|yes|1]e desativadas da seguinte maneira:
--no<option> --<option>=[false|no|0]
As opções de tristate geralmente são definidas como automáticas por padrão e podem ser ativadas à força da seguinte maneira:
--<option>=[true|yes|1]ou desativadas automaticamente da seguinte maneira:
--no<option> --<option>=[false|no|0]
Comandos
analyze-profile |
Analisa os dados do perfil do build. |
aquery |
Analisa os alvos fornecidos e consulta o gráfico de ação. |
build |
Cria os destinos especificados. |
canonicalize-flags |
Canoniza uma lista de opções do Bazel. |
clean |
Remove os arquivos de saída e, opcionalmente, interrompe o servidor. |
coverage |
Gera um relatório de cobertura de código para destinos de teste especificados. |
cquery |
Carrega, analisa e consulta os destinos especificados com configurações. |
dump |
Despeja o estado interno do processo do servidor do Bazel. |
fetch |
Busca repositórios externos que são pré-requisitos para os destinos. |
help |
Imprime a ajuda para os comandos ou o índice. |
info |
Exibe informações do ambiente de execução sobre o servidor do Bazel. |
license |
Imprime a licença deste software. |
mobile-install |
Instala os destinos em dispositivos móveis. |
modquery |
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 |
Interrompe o servidor do Bazel. |
sync |
Sincroniza todos os repositórios especificados no arquivo do espaço de trabalho |
test |
Cria e executa os destinos de teste especificados. |
version |
Imprime informações de versão para o Bazel. |
Opções de inicialização
- 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 recorre ao JDK local para executar o servidor do Bazel e é encerrado.
Tags:affects_outputs
,loses_incremental_state
--[no]batch
padrão: "false"-
Se definido, o Bazel será executado como um processo do cliente sem um servidor, em vez de no modo cliente/servidor padrão. Essa opção foi descontinuada e será removida. Para evitar que os servidores permaneçam, desative-os explicitamente.
Tags:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
padrão: "false"-
Apenas no Linux. Use a programação da CPU "em lote" para o Blaze. Essa política é útil para cargas de trabalho não interativas, mas que não querem diminuir esse valor. Consulte 'homem 2 sched_setscheduler'. Se for falso, o Bazel não realizará uma chamada do sistema.
Tags:host_machine_resource_optimizations
- Padrão
--bazelrc=<path>
: ver 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 todas as "--bazelrc" futuras serão ignoradas, o que é útil para desativar a pesquisa de um arquivo rc do usuário, por exemplo, em versões 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 que encontrar nos dois locais a seguir: 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 substituirão qualquer opção no Bazelrc.
Tags:changes_inputs
--[no]block_for_lock
padrão: "true"-
Quando --noblock_for_lock é passado, o Bazel não espera 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 para stderr. Alterar essa opção não fará com que o servidor seja reiniciado.
Tags:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
padrão: "30"-
O tempo que o cliente espera a cada tentativa de conexão com o servidor
Tags:bazel_internal_configuration
--[no]expand_configs_in_place
padrão: "true"-
A expansão de sinalizações --config foi feita para ser feita no local, não em uma expansão de ponto fixo entre as opções comuns de rc e as opções especificadas da linha de comando.
Tags:no_op
,deprecated
- Padrão
--failure_detail_out=<path>
: ver descrição -
Se definido, especifica um local para gravar uma mensagem protobuf fail_detail, se o servidor tiver uma falha e não puder informá-la via gRPC, normalmente. Caso contrário, o local será ${OUTPUT_BASE}/failure_detail.rawproto.
Tags:affects_outputs
,loses_incremental_state
--[no]home_rc
padrão: "true"-
Procure ou não o arquivo do Bazelrc doméstico em $HOME/.bazelrc
Tags:changes_inputs
--[no]idle_server_tasks
padrão: "true"-
Execute 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, independentemente dos valores de outras sinalizações de modificação de rc, mesmo que esses sinalizadores venham mais tarde na lista de opções de inicialização.
Tags:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
padrão: "-1"-
Somente no Linux. Defina um nível de 0 a 7 para a programação de E/S de melhor esforço usando a chamada de sistema sys_ioprio_set. 0 é a prioridade mais alta, 7 é a mais baixa. O programador antecipatório só pode cumprir a prioridade 4. Se for definido como um valor negativo, o Bazel não realizará uma chamada do sistema.
Tags:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
padrão: "120"-
O tempo máximo que o cliente aguarda para se conectar ao servidor
Tags:bazel_internal_configuration
--macos_qos_class=<a string>
padrão: "default"-
Define a classe de serviço QoS do servidor Bazel durante a execução no macOS. Esse sinalizador não tem efeito em todas as outras plataformas, mas é suportado para garantir que os arquivos rc possam ser compartilhados entre eles sem alterações. Os valores possíveis são: "interativo do usuário", "iniciado pelo usuário", "padrão", "utilitário" e "segundo plano".
Tags:host_machine_resource_optimizations
--max_idle_secs=<integer>
padrão: "10800"-
O número de segundos que o servidor de criação aguardará o período de inatividade antes de ser encerrado. Zero significa que o servidor nunca será desligado. Isso só é lido durante a inicialização do servidor. Alterar essa opção não fará com que o servidor reinicie.
Tags:eagerness_to_exit
,loses_incremental_state
- Padrão
--output_base=<path>
: ver descrição -
Se definido, especifica o local de saída em que todas as saídas de build serão gravadas. 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 para a próxima invocação do Bazel para esse valor, provavelmente 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, você pode ter várias bases de saída por espaço de trabalho e, assim, executar várias versões para o mesmo cliente na mesma máquina simultaneamente. Consulte "bazel help help shutdown" para saber como desligar um servidor Bazel.
Tags:affects_outputs
,loses_incremental_state
- Padrão
--output_user_root=<path>
: ver descrição -
O diretório específico do usuário sob o qual todas as saídas de build são gravadas. Por padrão, essa é uma função de $USER, mas, ao especificar uma constante, as saídas de build podem ser compartilhadas entre usuários colaboradores.
Tags:affects_outputs
,loses_incremental_state
--[no]preemptible
padrão: "false"-
Se verdadeiro, o comando poderá ser interrompido se outro comando for iniciado.
Tags:eagerness_to_exit
- Padrão
--server_jvm_out=<path>
: ver descrição -
O local para gravar a saída da JVM do servidor. Se não for definido, o padrão será um local em output_base.
Tags:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
padrão: "false"-
Se max_idle_secs estiver definido e o servidor de build estiver inativo por um tempo, desligue o servidor quando o sistema estiver com pouca RAM livre. Somente no Linux.
Tags:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
padrão: "true"-
Procura ou não o Bazelrc em todo o sistema.
Tags:changes_inputs
--[no]unlimit_coredumps
padrão: "false"-
Aumenta o limite do núcleo flexível para o limite absoluto a fim de possibilitar os núcleos do servidor (incluindo o JVM) e do cliente em condições comuns. Fixe essa sinalização no Bazelrc uma vez e esqueça-a para ter um núcleo quando encontrar uma condição que os aciona.
Tags:bazel_internal_configuration
--[no]watchfs
padrão: "false"-
Se verdadeiro, o Bazel tenta usar o serviço de monitoramento de arquivos do sistema operacional para fazer alterações locais em vez de verificar todos os arquivos em busca de alterações.
Tags:deprecated
--[no]windows_enable_symlinks
padrão: "false"-
Se verdadeiro, links simbólicos reais serão criados no Windows, em vez de cópias de arquivos. Requer que o modo de desenvolvedor do Windows esteja ativado e o Windows 10 versão 1703 ou superior.
Tags:bazel_internal_configuration
--[no]workspace_rc
padrão: "true"-
Procure ou não o arquivo do Bazelrc do espaço de trabalho em $workspace/.bazelrc.
Tags:changes_inputs
- Várias opções, não categorizadas de outra forma:
--host_jvm_args=<jvm_arg>
usos múltiplos foram acumulados- Sinalizações a serem transmitidas para a JVM que executa o Blaze.
--host_jvm_debug
-
Opção de conveniência para adicionar mais algumas sinalizações de inicialização do JVM, que fazem com que o JVM aguarde durante a inicialização até você se conectar de um depurador compatível com JDWP (como o Eclipse) à porta 5005.
Expande-se como:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
padrão: ""- Opção de conveniência para adicionar algumas sinalizações de inicialização do JVM específicas do criador de perfil/depurador. O Bazel tem uma lista de valores conhecidos que mapeia para as sinalizações de inicialização da JVM codificadas, possivelmente pesquisando alguns caminhos codificados para determinados arquivos.
--server_javabase=<jvm path>
padrão: ""- Caminho para a JVM usada para executar o Bazel.
Opções comuns a todos os comandos
- Opções que controlam a execução da versão:
--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 não implica limite.
Tags:execution
--[no]incompatible_remote_dangling_symlinks
padrão: "true"-
Se definido como verdadeiro e --compatible_remote_symlinks também for verdadeiro, os links simbólicos nas saídas de ação poderão ficar suspensos.
Tags:execution
,incompatible_change
--[no]incompatible_remote_symlinks
padrão: "true"-
Se definido como verdadeiro, o Bazel representará links simbólicos em saídas de ação no protocolo remoto de armazenamento em cache/execução como tal. Caso contrário, os links simbólicos serão seguidos e representados como arquivos ou diretórios. Consulte #6631 para obter detalhes.
Tags:execution
,incompatible_change
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--bep_maximum_open_remote_upload_files=<an integer>
padrão: "-1"-
Número máximo de arquivos abertos permitidos durante o upload do artefato BEP.
Tags:affects_outputs
--remote_download_minimal
-
Não faz o download de nenhuma saída de build remota para a máquina local. Essa sinalização é um atalho para as sinalizações: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files e --remote_download_outputs=minimal.
Expande-se para:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
Tags:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
padrão: "todos"- Se definida como "minimal", o download de saídas de compilação remota não será feito na máquina local, exceto as exigidas pelas ações locais. Se definido como "toplevel" se comporta como "minimal", exceto que também faz o download de saídas de destinos de nível superior para a máquina local. Ambas as opções podem reduzir significativamente os tempos de compilação se a largura de banda da rede for um gargalo.
Tags:affects_outputs
--remote_download_symlink_template=<a string>
padrão: ""-
Em vez de fazer o download de saídas de build remotas para a máquina local, crie links simbólicos. O destino dos links simbólicos pode ser especificado na forma de uma string de modelo. Essa string de modelo pode conter {hash} e {size_bytes} que se expandem para o hash do objeto e o tamanho em bytes, respectivamente. 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 de saídas remotas de destinos de nível superior para a máquina local. Essa sinalização é um atalho para sinalizações: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files e --remote_download_outputs=toplevel.
Expande-se como:
--action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tags:affects_outputs
--repo_env=<a 'name=value' assignment with an optional value part>
usos múltiplos foram acumulados-
Especifica outras variáveis de ambiente disponíveis somente para regras de repositório. As regras de repositório veem o ambiente completo mesmo assim, mas, dessa maneira, as informações de configuração podem ser passadas para os repositórios por meio de opções sem invalidar o gráfico de ação.
Tags:action_command_lines
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--[no]check_bzl_visibility
padrão: "true"-
Se desativado, os erros de visibilidade de carregamento .bzl são rebaixados para avisos.
Tags:build_file_semantics
- Essa opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, .bzl ou WORKSPACE:
--[no]enable_bzlmod
padrão: "false"-
Se verdadeiro, ativa o sistema de gerenciamento de dependências Bzlmod, com precedência sobre WORKSPACE. Para mais informações, acesse https://bazel.build/docs/bzlmod.
Tags:loading_and_analysis
--[no]experimental_action_resource_set
padrão: "true"-
Se definido como verdadeiro, ctx.actions.run() e ctx.actions.run_shell() aceitarão um parâmetro resource_set para execução local. Caso contrário, o padrão será 250 MB de memória e 1 CPU.
Tags:execution
,build_file_semantics
,experimental
-
Se definido como verdadeiro, 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. Veja mais detalhes em https://github.com/bazelbuild/bazel/issues/8830.
Tags:build_file_semantics
,experimental
--[no]experimental_analysis_test_call
padrão: "true"-
Se definida como verdadeira, a chamada nativa analytics_test estará disponível.
Tags:loading_and_analysis
,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 a finalidade de instruções load().
Tags:loading_and_analysis
,experimental
-
Se ela for definida como verdadeira, os atributos e os métodos da API Starlark necessários para a regra cc_shared_library estarão disponíveis.
Tags:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
padrão: "false"-
Se definido como verdadeiro, o pacote externo gerado automaticamente não estará disponível. O Bazel ainda não poderá analisar o arquivo 'external/BUILD', mas os globs que chegam a external/ do pacote sem nome funcionarão.
Tags:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
padrão: "false"-
Se definida como verdadeira, ativa as APIs necessárias para oferecer suporte à migração do Android Starlark.
Tags:build_file_semantics
--[no]experimental_enable_scl_dialect
padrão: "false"-
Se definido como verdadeiro, os arquivos .scl poderão ser usados em instruções load().
Tags:build_file_semantics
--[no]experimental_get_fixed_configured_action_env
padrão: "false"-
Se ativado, o action.env também retornará variáveis de ambiente fixas especificadas na configuração de recursos.
Tags:loading_and_analysis
,experimental
--[no]experimental_google_legacy_api
padrão: "false"-
Se definido como verdadeiro, expõe várias partes experimentais da API Starlark referentes ao código legado do Google.
Tags:loading_and_analysis
,experimental
--[no]experimental_java_library_export
padrão: "false"-
Se ativado, o módulo experimental_java_library_export_do_not_use está disponível.
Tags:loading_and_analysis
,incompatible_change
--[no]experimental_lazy_template_expansion
padrão: "true"-
Se definido como verdadeiro, ctx.actions.expand_template() aceitará um parâmetro TemplateDict para a avaliação adiada dos valores de substituição.
Tags:execution
,build_file_semantics
,experimental
--[no]experimental_platforms_api
padrão: "false"-
Se definido como verdadeiro, ativa várias APIs 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 terá alguns recursos de execução remota.
Tags:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
padrão: "false"-
Se definido como verdadeiro, os repositórios não principais serão plantados como links simbólicos para o repositório principal na raiz de execução. Ou seja, todos os repositórios são filhos diretos do diretório $output_base/execution_root. Isso tem o efeito colateral de liberar $output_base/execution_root/__main__/external para o diretório "external" de nível superior real.
Tags:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]incompatible_always_check_depset_elements
padrão: "true"-
Verifique a validade de elementos adicionados a dependências em todos os construtores. Os elementos devem ser imutáveis, mas historicamente o construtor depset(direct=...) esqueceu de verificar. Use tuplas em vez de listas em elementos dependentes. Consulte https://github.com/bazelbuild/bazel/issues/10313 para ver mais detalhes.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
padrão: "true"-
Quando verdadeiro, o Bazel não retorna mais uma lista de linked_context.libraries_to_link, mas retorna um depset.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
padrão: "false"-
Se for definida como verdadeira, os atributos da regra não poderão definir "cfg = "host". As regras devem definir "cfg = "exec"".
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
padrão: "false"-
Se definido como verdadeiro, desativa a capacidade de acessar provedores em objetos "de destino" por meio da sintaxe de campo. Use a sintaxe de chave de provedor. Por exemplo, em vez de usar "ctx.attr.dep.my_info" para acessar "my_info" dentro de uma função de implementação de regra, use "ctx.attr.dep[MyInfo]". Consulte mais detalhes em https://github.com/bazelbuild/bazel/issues/9014.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
padrão: "false"-
Se definido como verdadeiro, o valor padrão do argumento "allow_empty" de glob() será "False".
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
padrão: "true"-
Obsoleto. Ambiente autônomo.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
padrão: "false"-
Se definido como verdadeiro, as funções de implementação de regras podem não retornar uma estrutura. Em vez disso, eles precisam retornar uma lista de instâncias de provedor.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_existing_rules_immutable_view
padrão: "true"-
Se definido como verdadeiro, native.existing_rule e nativo.existing_rules retornará objetos de visualização imutáveis leves em vez de dicionários mutáveis.
Tags:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
padrão: "true"-
No atributo "packages" do package_group, o significado do valor "//..." é alterado para se referir a todos os pacotes do repositório atual em vez de todos os pacotes em qualquer repositório. Você pode usar o valor especial "public" no lugar de "//..." para obter o comportamento antigo. Esta sinalização requer que a opção --compatible_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 verdadeiro, os parâmetros output_jar e host_javabase em pack_sources e host_javabase na compilação serão removidos.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_new_actions_api
padrão: "true"-
Se definida como verdadeira, a API para criar ações só estará disponível em "ctx.actions", e não em "ctx".
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
padrão: "true"-
Se definida como verdadeira, 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) sã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_rule_outputs_param
padrão: "false"-
Se definido como verdadeiro, desativa o parâmetro "outputs" da função "Starlark" de "rule()`".
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
padrão: "true"-
No atributo "packages" do package_group, é possível 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 definida como verdadeira, a regra create_linking_context exigirá linker_inputs em vez de library_to_link. Os getters antigos do link_context também serão desativados e apenas linker_inputs estará disponível.
Tags:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
padrão: "true"-
Se definido como verdadeiro, o parâmetro de comando de actions.run_shell aceitará apenas strings
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
padrão: "false"-
Se ativados, alguns módulos específicos da linguagem, como "cc_common", não estão disponíveis nos arquivos .bzl do usuário e só podem ser chamados nos respectivos repositórios de regras.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
padrão: "false"-
Desativa os métodos to_json e to_proto do struct, que poluem o namespace do campo struct. Em vez disso, use json.encode ou json.encode_indent para JSON ou proto.encode_text para textproto.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
padrão: "false"-
Se definido como verdadeiro, o aspecto de nível superior respeitará os provedores necessários e só será executado em destinos de nível superior cujos provedores anunciados de regras satisfaçam os provedores necessários do aspecto.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
padrão: "true"-
Quando verdadeiro, o Bazel cria uma string do marcador @//foo:bar como @//foo:bar, em vez de //foo:bar. Isso só afeta o comportamento de str(), o operador % e assim por diante. O comportamento de repr() não foi alterado. 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 verdadeiro, o Bazel não permite mais o uso de cc_configure de @bazel_tools. Consulte https://github.com/bazelbuild/bazel/issues/10134 para ver detalhes e instruções de migração.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
padrão: "false"-
Se definida como verdadeira, a visibilidade dos atributos da regra privada será verificada em relação à definição da regra, e não ao uso dela.
Tags:build_file_semantics
,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 que não há limite).
Tags:build_file_semantics
--nested_set_depth_limit=<an integer>
padrão: "3500"-
A profundidade máxima do gráfico interno para um conjunto (também conhecido como NestedSet) acima do qual o construtor depset() falhará.
Tags:loading_and_analysis
- Opções que acionam otimizações do tempo de compilação:
--[no]heuristically_drop_nodes
padrão: "false"-
Se verdadeiro, o Blaze removerá os nós FileState e DirectoryListingState após a conclusão do nó File e DirectoryListing relacionado para economizar memória. Esperamos que esses nós tenham menos probabilidade de serem necessários novamente. Em caso afirmativo, ele será reavaliado pelo programa.
Tags:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
padrão: "true"-
Quando verdadeiro, o Bazel não modifica mais as sinalizações de linha de comando usadas para vinculação e também não decide seletivamente quais sinalizações vão para o arquivo de parâmetros e quais não. Veja mais detalhes em https://github.com/bazelbuild/bazel/issues/7670.
Tags:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
padrão: "true"-
Se falso, o Blaze descartará o estado na memória dessa versão quando a versão for concluída. Versões subsequentes não terão incrementabilidade com relação a esta.
Tags:loses_incremental_state
--[no]track_incremental_state
padrão: "true"-
Se falso, o Blaze não manterá dados que permitam a invalidação e reavaliação de builds incrementais para economizar memória nesse build. Versões subsequentes não terão incrementabilidade com relação a esta. Normalmente, convém especificar --batch ao definir isso como falso.
Tags:loses_incremental_state
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]announce_rc
padrão: "false"-
Se as opções de rc serão anunciadas.
Tags:affects_outputs
--[no]attempt_to_print_relative_paths
padrão: "false"-
Ao imprimir a parte do local das mensagens, tente usar um caminho relativo ao diretório do espaço de trabalho ou a um dos diretórios especificados por --package_path.
Tags:terminal_output
--bes_backend=<a string>
padrão: ""-
Especifica o endpoint de back-end do serviço de evento 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 considerará grpcs.
Tags:affects_outputs
--[no]bes_check_preceding_lifecycle_events
padrão: "false"-
Define o campo check_preceding_lifecycle_events_present em PublishBuildToolEventStreamRequest, que informa ao BES se ele recebeu anteriormente eventos InvocationAttemptStarted e BuildEnqueued que correspondem ao evento da ferramenta atual.
Tags:affects_outputs
--bes_header=<a 'name=value' assignment>
usos múltiplos foram acumulados-
Especifique um cabeçalho no formulário NAME=VALUE que será incluído em solicitações BES. É possível transmitir vários cabeçalhos especificando a sinalização várias vezes. Vários valores para o mesmo nome serão convertidos em uma lista separada por vírgulas.
Tags:affects_outputs
- Padrão
--bes_instance_name=<a string>
: ver descrição -
Especifica o nome da instância em que o BES manterá o BEP enviado. O padrão é nulo.
Tags:affects_outputs
--bes_keywords=<comma-separated list of options>
usos múltiplos foram 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=<nome_do_comando> ", "nome_do_protocolo=BEP"). O padrão é nenhum.
Tags:affects_outputs
--[no]bes_lifecycle_events
padrão: "true"-
Especifica se é necessário publicar eventos do ciclo de vida do BES. (o padrão é "true").
Tags:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
padrão: "10m"-
Especifica por quanto tempo o Bazel deve aguardar a conclusão do upload BES/BEP durante a operação sem fins lucrativos. Essa sinalização garante o encerramento quando a JVM apresenta sobrecarga grave de GC e não pode progredir em qualquer thread do usuário.
Tags:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
padrão: "10240"-
Especifica o tamanho máximo de stdout ou stderr a ser armazenado em buffer no BEP, antes de ser relatado como um evento de progresso. 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
- Padrão
--bes_proxy=<a string>
: ver descrição - Conecte-se ao serviço de eventos de versão por meio de um proxy. Essa sinalização 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 enviará o URL anexado pelo ID de invocação ao terminal.
Tags:terminal_output
--bes_system_keywords=<comma-separated list of options>
usos múltiplos foram acumulados-
Especifica uma lista de palavras-chave de notificação a serem incluídas diretamente, sem o prefixo "user_keyword=" incluído nas palavras-chave fornecidas por meio de --bes_keywords. Destinado a operadores de serviço de versão que definem --bes_lifecycle_events=false e incluem palavras-chave ao chamar PublishLifecycleEvent. Os operadores de serviço de build que usam essa sinalização precisam impedir que os usuários modifiquem o valor dela.
Tags:affects_outputs
--bes_timeout=<An immutable length of time.>
padrão: "0s"- Especifica o tempo que o Bazel deve aguardar a conclusão do upload BES/BEP após a conclusão da compilação 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 serviço de eventos de build precisa bloquear a conclusão do build ou encerrar a invocação imediatamente e concluir o upload em segundo plano. "wait_for_upload_complete" (padrão), "nowait_for_upload_complete" ou "full_async".
Tags:eagerness_to_exit
--build_event_binary_file=<a string>
padrão: ""-
Se não estiver vazio, grave nesse arquivo uma representação binária delimitada por varint de representação do protocolo do evento de build. Esta opção implica --bes_upload_mode=wait_for_upload_complete.
Tags:affects_outputs
--[no]build_event_binary_file_path_conversion
padrão: "true"-
Converta caminhos na representação de arquivos binários do protocolo do evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema file:// uri sempre será usado
Tags:affects_outputs
--build_event_json_file=<a string>
padrão: ""-
Se o campo não estiver vazio, grave uma serialização JSON do protocolo de evento de build nesse arquivo.
Tags:affects_outputs
--[no]build_event_json_file_path_conversion
padrão: "true"-
Converta caminhos na representação do arquivo json do protocolo do evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema file:// uri sempre será usado
Tags:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
padrão: "-1"-
O número máximo de entradas para um único evento nomeada_set_of_files. Valores menores que 2 são ignorados e nenhuma divisão de eventos é realizada. O objetivo é limitar o tamanho máximo do evento no protocolo do evento de versão, embora não controle diretamente o tamanho do evento. O tamanho total do evento é uma função da estrutura do conjunto, bem como do tamanho do arquivo e do uri, que, por sua vez, podem depender da função de hash.
Tags:affects_outputs
--[no]build_event_publish_all_actions
padrão: "false"-
Se todas as ações precisam ser publicadas.
Tags:affects_outputs
--build_event_text_file=<a string>
padrão: ""-
Se o campo não estiver vazio, grave uma representação textual do protocolo do evento de build nesse arquivo
Tags:affects_outputs
--[no]build_event_text_file_path_conversion
padrão: "true"-
Converta caminhos na representação do arquivo de texto do protocolo do evento de build em URIs mais válidos globalmente sempre que possível. Se desativado, o esquema file:// uri sempre será usado
Tags:affects_outputs
--[no]experimental_announce_profile_path
padrão: "false"-
Se ativado, adiciona o caminho do perfil JSON ao registro.
Tags:bazel_monitoring
--[no]experimental_bep_target_summary
padrão: "false"- Se os eventos TargetSummary serão publicados.
--[no]experimental_build_event_expand_filesets
padrão: "false"-
Se verdadeiro, expanda Filesets no BEP ao apresentar arquivos de saída.
Tags:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
padrão: "false"-
Se verdadeiro, resolve totalmente os links simbólicos do conjunto de arquivos relativo no BEP ao apresentar arquivos de saída. Requer --experimental_build_event_expand_filesets.
Tags:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
padrão: "4"-
O número máximo de vezes que o Bazel tentará fazer o upload de um evento de versão novamente.
Tags:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
padrão: "1s"-
Atraso inicial inicial para novas tentativas de retirada exponencial quando o upload do BEP falha. (expoente: 1.6)
Tags:bazel_internal_configuration
- Padrão
--experimental_build_event_upload_strategy=<a string>
: ver descrição -
Seleciona como fazer upload de 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 perfil coleta os dados PSI do Linux.
Tags:bazel_monitoring
--[no]experimental_collect_resource_estimation
padrão: "false"-
Se ativado, o criador de perfil coleta estimativas de uso de CPU e memória para ações locais.
Tags:bazel_monitoring
--[no]experimental_collect_system_network_usage
padrão: "false"-
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 os dados de recursos agregados do worker.
Tags:bazel_monitoring
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, dynamic_lock or unknown>
usos múltiplos foram acumulados-
Especifica outras tarefas a serem incluídas no perfil.
Tags:bazel_monitoring
--[no]experimental_profile_include_primary_output
padrão: "false"-
Inclui o atributo "out" extra nos 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_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_stream_log_file_uploads
padrão: "false"-
Faça o upload dos arquivos de registros por streaming diretamente para o armazenamento remoto, em vez de gravá-los em disco.
Tags:affects_outputs
- Padrão
--experimental_workspace_rules_log_file=<a path>
: ver descrição - Registre determinados eventos de regras de espaço de trabalho neste arquivo como protótipos de espaço de trabalho delimitados.
--[no]generate_json_trace_profile
padrão: "auto"-
Se ativado, o Bazel cria o perfil do build e grava um perfil no formato JSON em um arquivo na base de saída. Veja o perfil carregando em chrome://tracing. Por padrão, o Bazel grava o perfil para todos os comandos e consultas da versão.
Tags:bazel_monitoring
--[no]heap_dump_on_oom
padrão: "false"-
Se você quer emitir manualmente um despejo de heap se uma OOM for gerada (incluindo OOMs devido a --experimental_oom_more_eagerly_threshold). O despejo será gravado em <output_base>/<invocation_id>.heapdump.hprof. Essa opção substitui efetivamente -XX:+HeapDumpOnOutOfMemoryError, que não tem efeito porque os OOMs são capturados e redirecionados para Runtime#halt.
Tags:bazel_monitoring
--[no]legacy_important_outputs
padrão: "true"-
Use-o para suprimir a geração do campo "important_outputs" legado no evento TargetComplete. Essa função é necessária para a integração do Bazel à ResultStore.
Tags:affects_outputs
--logging=<0 <= an integer <= 6>
padrão: "3"-
O nível de geração de registros.
Tags:affects_outputs
- Padrão
--memory_profile=<a path>
: ver descrição -
Se definido, grava dados de uso de memória no arquivo especificado no final da fase e heap estável no registro mestre no final da compilação.
Tags:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
padrão: "1,0"-
Ajuste o cálculo do heap estável do perfil de memória no final da compilação. Deve ser um número inteiro separado por vírgulas. Em cada par, o primeiro número inteiro é o número de GCs a executar. O segundo número inteiro em cada par é o número de segundos de espera entre as GCs. Por exemplo: 2,4,4,0 faria 2 GCs com uma pausa de 4 segundos, seguidas por 4 GCs com pausa de zero segundo
Tags:bazel_monitoring
- Padrão
--profile=<a path>
: ver descrição -
Se definido, crie um perfil do Bazel e grave dados no arquivo especificado. Use o bazel parse-profile para analisar o perfil.
Tags:bazel_monitoring
--[no]record_full_profiler_data
padrão: "false"-
Por padrão, o Bazel Profiler registra apenas dados agregados para eventos rápidos, mas numerosos, como estatísticas do arquivo. Se essa opção for ativada, o criador de perfil registrará cada evento, resultando em dados de criação de perfil mais precisos, mas com desempenho de LARGE. A opção só tem efeito se --profile também for usado.
Tags:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
padrão: "falha"-
Escolha quando imprimir mensagens de execução remota. Os valores válidos são `failure`, para imprimir apenas em falhas, `success` para imprimir apenas em caso de falhas e `all` para imprimir sempre.
Tags:terminal_output
--[no]slim_profile
padrão: "true"-
Reduzirá o tamanho do perfil JSON mesclando eventos se ele ficar muito grande.
Tags:bazel_monitoring
--starlark_cpu_profile=<a string>
padrão: ""-
Grava no arquivo especificado um perfil pprof de uso da CPU por todas as linhas de execução do Starlark.
Tags:bazel_monitoring
--tool_tag=<a string>
padrão: ""-
Um nome de ferramenta para atribuir a esta invocação do Bazel.
Tags:affects_outputs
,bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
usos múltiplos foram acumulados-
Especifica quais eventos serão mostrados na IU. É possível adicionar ou remover eventos para os padrão usando +/- no início ou substituir completamente o conjunto padrão por atribuição direta. O conjunto de tipos de evento compatíveis inclui INFO, DEBUG, ERROR e mais.
Tags:terminal_output
- Opções de execução e armazenamento em cache remoto:
- Padrão
--experimental_circuit_breaker_strategy=<failure>
: ver descrição -
Especifica a estratégia a ser usada pelo disjuntor. As estratégias disponíveis são "falha". Em um valor inválido para a opção, o comportamento da opção não é definido.
Tags:execution
--[no]experimental_guard_against_concurrent_changes
padrão: "false"- Desative essa opção para desativar a verificação do tamanho dos arquivos de entrada de uma ação antes de fazer upload dela para um cache remoto. Pode haver casos em que o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
--[no]experimental_remote_cache_async
padrão: "false"- Se for verdadeiro, a E/S do cache remoto ocorrerá em segundo plano em vez de ocorrer como parte de uma geração.
--experimental_remote_cache_ttl=<An immutable length of time.>
padrão: "3h"-
O TTL mínimo garantido de blobs no cache remoto depois que os resumos são referenciados recentemente, por exemplo, por um ActionResult ou um FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs. Por exemplo, ele não chama GetActionResult repetidamente em uma compilação incremental. O valor precisa ser um pouco menor do que o TTL real, já que há uma lacuna entre o momento em que o servidor retorna os resumos e o momento em que o Bazel os recebe.
Tags:execution
- Padrão
--experimental_remote_capture_corrupted_outputs=<a path>
: ver 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: "false"- Se esta política for definida como verdadeira, descarte cópias na memória da árvore de Merkle da raiz de entrada e mapeamentos de entrada associados durante chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso de memória, mas exige que o Bazel faça um novo cálculo em ausências e tentativas de cache remota.
- Padrão
--experimental_remote_downloader=<a string>
: ver descrição - Um URI de endpoint da API Remote Asset, para ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. 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 a ferramenta de download remota falha quando é usada novamente.
--[no]experimental_remote_execution_keepalive
padrão: "false"- O uso de sinal de atividade para chamadas de execução remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
padrão: "10"-
Define o número permitido de taxa de falhas em porcentagem para uma janela de tempo específica. Depois disso, ele interrompe a chamada ao cache/executor remoto. Por padrão, o valor é 10. Definir como 0 significa que não há limitação.
Tags:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
padrão: "60 s"-
O intervalo em que a taxa de falha das solicitações remotas é calculada. Em valor zero ou negativo, a duração da falha é calculada em toda a duração da execução.As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
Tags:execution
--[no]experimental_remote_mark_tool_inputs
padrão: "false"- Se definido como verdadeiro, o Bazel marcará as entradas como entradas de ferramenta para o executor remoto. Isso pode ser usado para implementar workers permanentes remotos.
--[no]experimental_remote_merkle_tree_cache
padrão: "false"- Se definida como verdadeira, os cálculos da árvore do Merkle serão memorizados para melhorar a velocidade de verificação de ocorrência em cache remoto. A impressão na memória do cache é controlada por --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
padrão: "1000"- O número de árvores do Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrência em cache remoto. Mesmo que o cache seja automaticamente removido de acordo com o tratamento de referências leves do Java, erros de falta de memória podem ocorrer se a configuração for muito alta. Se definido como 0, o tamanho do cache é ilimitado. O valor ideal varia de acordo com o tamanho do projeto. O padrão é 1.000.
--[no]incompatible_remote_build_event_upload_respect_no_cache
padrão: "false"- Obsoleto. Ambiente autônomo. Use --remote_build_event_upload=minimal.
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
padrão: "true"-
Se definido como verdadeiro, uma ação executada remotamente não poderá produzir um artefato de árvore contendo um link simbólico relativo. Os links simbólicos absolutos nunca são permitidos, independentemente dessa sinalização.
Tags:execution
,incompatible_change
--[no]incompatible_remote_downloader_send_all_headers
padrão: "true"-
Se todos os valores de um cabeçalho com vários valores serão enviados para o download remoto em vez de apenas o primeiro.
Tags:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
padrão: "false"-
Se definido como verdadeiro, os caminhos de saída serão relativos à raiz de entrada em vez do diretório de trabalho.
Tags:incompatible_change
--[no]incompatible_remote_results_ignore_disk
padrão: "true"-
Se definido como verdadeiro, --noremote_upload_local_results e --noremote_accept_cached não se aplicarão ao cache de disco. Se --disk_cache e --remote_cache estiverem definidos (combinados):
--noremote_upload_local_results fará com que os resultados sejam gravados no cache de disco, mas não enviados ao cache remoto.
--noremote_accept_cached faz com que o Bazel verifique os resultados no cache do disco, mas não no cache remoto.
ações no-remote-exec podem atingir o cache de disco.
Consulte #8216 para obter detalhes.
Tags:incompatible_change
--[no]remote_accept_cached
padrão: "true"- Se os resultados da ação serão armazenados em cache remotamente.
--remote_build_event_upload=<all or minimal>
padrão: "mínima"- Se definido como "todos", todas as saídas locais referenciadas pelo BEP são enviadas para o cache remoto. Se definido como "mínimo", as saídas locais referenciadas pelo BEP não são enviadas para o cache remoto, exceto para arquivos que são importantes para os consumidores do BEP (por exemplo, registros de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o URI de arquivos mesmo se não estiverem armazenados no cache remoto. O padrão é "minimal".
- Padrão
--remote_bytestream_uri_prefix=<a string>
: ver descrição - O nome do host e o nome da instância a serem usados nos URIs bytestream:// que são gravados nos fluxos de eventos de versão. Essa opção pode ser definida quando versões são executadas 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}".
- Padrão
--remote_cache=<a string>
: ver descrição - Um URI de um endpoint de armazenamento em cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. Especifique o esquema grpc://, http:// ou unix: para desativar o TLS. Consulte https://bazel.build/remote/caching.
--[no]remote_cache_compression
padrão: "false"- Se ativada, compacte/descompacte os blobs de cache com o zstd.
--remote_cache_header=<a 'name=value' assignment>
usos múltiplos foram 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 sinalização 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>
usos múltiplos foram acumulados-
Defina as propriedades exec padrão para serem usadas como a plataforma de execução remota se uma plataforma de execução ainda não tiver definido exec_properties.
Tags:affects_outputs
--remote_default_platform_properties=<a string>
padrão: ""- Defina as propriedades da plataforma padrão que serão definidas para a API de execução remota, se a plataforma de execução ainda não tiver definido remote_execution_properties. Esse valor também será usado se a plataforma do host for selecionada como a plataforma de execução remota.
--remote_downloader_header=<a 'name=value' assignment>
usos múltiplos foram acumulados- Especifique um cabeçalho que será incluído nas solicitações de download remoto: --remote_downloader_header=Name=Value. É possível transmitir vários cabeçalhos especificando a sinalização 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>
usos múltiplos foram 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 sinalização 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.
- Padrão
--remote_executor=<a string>
: ver 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 (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. Especifique o esquema grpc:// ou unix: para desativar o TLS.
- Padrão
--remote_grpc_log=<a path>
: ver descrição - Se especificada, um caminho para um arquivo para registrar detalhes relacionados à chamada gRPC. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados com cada mensagem prefixada por um varint que indica o tamanho da seguinte mensagem protobuf serializada, conforme realizada pelo método LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
usos múltiplos foram 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 sinalização 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 a estratégia de execução local independente retorna à execução em caso de falha.
--remote_local_fallback_strategy=<a string>
padrão: "local"- Ambiente autônomo, obsoleto. Veja mais detalhes em https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
padrão: "100"-
Limite o número máximo de conexões simultâneas ao 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 lidar com uma solicitação por vez, então o Bazel pode fazer até --remote_max_connections solicitações simultâneas.
Para cache/executor remoto do gRPC, um canal gRPC geralmente aceita mais de 100 solicitações simultâneas. Assim, o Bazel faz cerca de solicitações "--remote_max_connections * 100".
Tags:host_machine_resource_optimizations
- Padrão
--remote_proxy=<a string>
: ver descrição - Conecte-se ao cache remoto por meio de um proxy. Essa sinalização 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 de ações remotas a serem armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
--remote_retries=<an integer>
padrão: "5"- O número máximo de tentativas de repetir um erro temporário. Se definido como 0, as tentativas serão desativadas.
--remote_retry_max_delay=<An immutable length of time.>
padrão: "5s"- O atraso máximo de espera entre as tentativas de repetição remota. 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.
--remote_timeout=<An immutable length of time.>
padrão: "60 s"- O tempo máximo de espera para execução remota e chamadas de cache. Para o cache REST, são usados 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 é necessário fazer upload dos resultados de ação executados localmente no cache remoto se o cache remoto for compatível e o usuário estiver autorizado a fazer isso.
--[no]remote_verify_downloads
padrão: "true"- Se definido como verdadeiro, o Bazel 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>
usos múltiplos foram acumulados-
Pares de string de chave-valor personalizados para fornecer em um evento de build.
Tags:terminal_output
--color=<yes, no or auto>
padrão: "auto"- Use os controles do terminal para colorir a saída.
--config=<a string>
usos múltiplos foram acumulados- Seleciona seções de configuração adicionais dos arquivos rc. Para cada <command>, ele também extrai as opções de <command>:<config> se essa seção existir. Se essa seção não existir em um arquivo .rc, o Blaze falhará com um erro. As seções de configuração e as combinações de sinalizações às quais elas são equivalentes estão localizadas nos arquivos de configuração tools/*.blazerc.
--curses=<yes, no or auto>
padrão: "auto"- Use os controles do cursor do terminal para minimizar a saída de rolagem.
- Padrão
--disk_cache=<a path>
: ver descrição - Um caminho para um diretório em que o Bazel lê e grava ações e saídas. Se o diretório não existir, ele será criado.
--[no]enable_platform_specific_config
padrão: "false"- Se verdadeiro, o Bazel seleciona linhas de configuração específicas do SO do host dos arquivos do Bazelrc. Por exemplo, se o sistema operacional do host for Linux e você executar a compilação do Bazel, o Bazel escolherá as linhas que começam com build:linux. Os identificadores de SO compatíveis são linux, macos, windows, freebsd e openbsd. Ativar essa sinalização é equivalente a usar --config=linux no Linux, --config=windows no Windows etc.
--experimental_credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
usos múltiplos foram acumulados- Configura um auxiliar de credenciais para recuperar credenciais de autorização para busca de repositório, armazenamento em cache e execução remotos e serviço de evento de versão. As credenciais fornecidas por um auxiliar têm precedência sobre as credenciais fornecidas por --google_default_credentials, --google_credentials, um arquivo .netrc ou o parâmetro de autenticação para repository_ctx.download e repository_ctx.download_and_extract. Pode ser especificado várias vezes para configurar vários auxiliares. Consulte https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md para ver mais detalhes.
--experimental_credential_helper_cache_duration=<An immutable length of time.>
padrão: "30m"- A duração de armazenamento em cache das credenciais fornecidas por um auxiliar de credenciais. Invocar com um valor diferente ajusta o ciclo de vida das entradas preexistentes. Transmita zero para limpar o cache. Um comando clean sempre limpa o cache, independentemente desta sinalização.
--experimental_credential_helper_timeout=<An immutable length of time.>
padrão: "10s"- Configura o tempo limite para um auxiliar de credenciais. Os auxiliares de credenciais que não respondem dentro desse tempo limite falharão na invocação.
--[no]experimental_skymeld_ui
padrão: "false"-
Exibe o progresso da fase de análise e execução quando ambos estão sendo executados simultaneamente.
Tags:terminal_output
--[no]experimental_windows_watchfs
padrão: "false"- Se verdadeiro, o suporte experimental do Windows para --watchfs está ativado. Caso contrário, --watchfsis é um não operacional no Windows. Ative também --watchfs.
--google_auth_scopes=<comma-separated list of options>
padrão: "https://www.googleapis.com/auth/cloud-platform"- Uma lista separada por vírgulas dos escopos de autenticação do Google Cloud.
- Padrão
--google_credentials=<a string>
: ver descrição - Especifica o arquivo para receber as credenciais de autenticação. Veja mais detalhes em https://cloud.google.com/docs/authentication.
--[no]google_default_credentials
padrão: "false"- O uso de "Application Default Credentials do Google" para autenticação. Veja mais detalhes em https://cloud.google.com/docs/authentication. Desativado por padrão.
- Padrão
--grpc_keepalive_time=<An immutable length of time.>
: ver descrição - Configure pings de sinal de atividade para conexões gRPC de saída. Se estiver definido, o Bazel enviará 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 segunda granularidade. É um erro definir um valor menor que um segundo. Por padrão, os pings de sinal de atividade estão desativados. Entre em contato com o proprietário do serviço antes de ativar essa configuração. Por exemplo, para definir um valor de 30 segundos para essa sinalização, use "grpc_keepalive_time=30s".
--grpc_keepalive_timeout=<An immutable length of time.>
padrão: "20 s"- Configura um tempo limite de sinal de atividade para conexões gRPC de saída. Se os pings de sinal de atividade estiverem ativados com --grpc_keepalive_time, o Bazel expirará uma conexão se não receber uma resposta de ping depois desse tempo. Os horários são tratados como segunda granularidade. É um erro definir um valor menor que um segundo. Se os pings de sinal de atividade estiverem desativados, essa configuração será ignorada.
--[no]incompatible_disallow_symlink_file_to_dir
padrão: "true"-
Se definido como verdadeiro, `ctx.actions.symlink` não permitirá vincular um arquivo a um diretório.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
padrão: "true"-
Se definido como verdadeiro, `rule` não poderá ser chamado com o parâmetro `name`.
Tags:loading_and_analysis
,incompatible_change
--[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 ao ter várias guias de terminal.
--[no]show_progress
padrão: "true"- Exibe mensagens de progresso durante uma versão.
--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 em mensagens
- Padrão
--tls_certificate=<a string>
: ver descrição - Especifique um caminho para um certificado TLS confiável para assinar os certificados do servidor.
- Padrão
--tls_client_certificate=<a string>
: ver descrição - Especifique o certificado do cliente TLS a ser usado. Você também precisa fornecer uma chave de cliente para ativar a autenticação do cliente.
- Padrão
--tls_client_key=<a string>
: ver descrição - Especifique a chave do cliente TLS a ser usada. Você também precisa fornecer um certificado do cliente para ativar a autenticação do cliente.
--ui_actions_shown=<an integer>
padrão: "8"-
Número de ações simultâneas mostradas na barra de progresso detalhada. Cada ação é mostrada em uma linha separada. A barra de progresso sempre mostra pelo menos um. Todos os números menores que 1 são mapeados para 1.
Tags:terminal_output
--[no]watchfs
padrão: "false"- No Linux/macOS: se verdadeiro, o Bazel tenta usar o serviço de monitoramento de arquivos do sistema operacional para fazer alterações locais em vez de verificar todos os arquivos em busca de alterações. No Windows: essa sinalização não é operacional, mas pode ser ativada em conjunto com --experimental_windows_watchfs. Em qualquer sistema operacional: 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
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags Op
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--dump=<text or raw>
[-d
] padrão: ver descrição-
saída do perfil completo de dados do perfil no formato "texto" legível ou no formato "bruto" compatível com script.
Tags:affects_outputs
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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 armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
Opções do Aquery
Herda todas as opções de build.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags de ambiente autônomo
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica de consultas:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é {xml,proto,record}. "off" significa que nenhuma dependência de aspectos é resolvida, "conservadora" (o padrão) significa que todas as dependências declaradas são adicionadas, independentemente de terem recebido a classe de regra de dependências diretas, "preciso" significa que apenas os aspectos que são possivelmente ativos são adicionados, possivelmente dada a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, tornando-o mais lento do que os outros modos. Observe também que o modo preciso não é completamente preciso: a decisão de computar um aspecto é decidida na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]deduplicate_depsets
padrão: "true"-
Eliminar a duplicação de filhos não folhas de um dep_set_of_files na saída proto/textproto/json final. Isso não elimina as dependências que não compartilham um pai imediato. Isso não afeta a lista efetiva de artefatos de entrada das ações.
Tags:terminal_output
--[no]experimental_parallel_aquery_output
padrão: "false"- Se a saída proto/textproto da consulta precisa ser gravada em paralelo. Ambiente autônomo para os outros formatos de saída.
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido " fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos deles serão concatenados. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O tamanho máximo da string de rótulo para um nó de gráfico na saída. Marcadores mais longos ficarão truncados. -1 significa sem truncamento. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita é aquela que não está explicitamente especificada no arquivo BUILD, mas adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--[no]include_artifacts
padrão: "true"-
Inclui nomes das entradas e saídas de ação na saída (possivelmente grande).
Tags:terminal_output
--[no]include_aspects
padrão: "true"- aquery, cquery: se serão incluídas ações geradas por aspecto na saída. query: no-op (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 (possivelmente grande).
Tags:terminal_output
--[no]include_file_write_contents
padrão: "false"-
Inclua o conteúdo do arquivo para as ações FileWrite e SourceSymlinkManifest (possivelmente grande).
Tags:terminal_output
--[no]include_param_files
padrão: "false"-
Inclua o conteúdo dos arquivos de parâmetros usados no comando (possivelmente grande). Observação: ativar essa sinalização ativará automaticamente a sinalização --include_commandline.
Tags:terminal_output
--[no]incompatible_display_source_file_location
padrão: "true"-
Verdadeiro por padrão, mostra o destino do arquivo de origem. Se verdadeiro, exibe o local da linha 1 dos arquivos de origem nas saídas do local. Essa sinalização existe apenas para fins de migração.
Tags:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo `packages` do package_group, o `//` principal não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se "set" e "-universe_scope" não forem definidos, um valor de "--verse" será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo universal (por exemplo, `allrdeps`) pode não ser o que você quer. Portanto, use essa opção apenas se souber o que está fazendo. Consulte 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: esta opção se aplica somente a "consulta" (ou seja, não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Se cada formato é terminado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativada, as dependências dos atributos "nodep" serão incluídas no gráfico de dependência em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de compilação.
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 uma consulta são: text, textproto, proto, stream_proto, jsonproto.
Tags:terminal_output
--[no]proto:default_values
padrão: "true"-
Se verdadeiro, os atributos com valor não especificado explicitamente no arquivo BUILD são incluídos. Caso contrário, são omitidos. Essa opção é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto define_stack, que registra para cada instância de regra a pilha de chamadas Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativada, os atributos configuráveis criados por select() são simplificados. Para tipos de lista, a representação nivelada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulo.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo do proto source_aspect_name de cada Atributo com o aspecto de origem do atributo (string vazia se não tiver sido).
Tags:terminal_output
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Calcular ou não o atributo $internal_attr_hash.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Se é preciso enviar informações de local na saída proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "todos"-
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 é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Se os campos regra_entrada e regra_saída serão ou não preenchidos.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definida, a consulta lerá a consulta no arquivo chamado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, a localização dos arquivos BUILD em saídas xml e proto será relativa. Por padrão, a saída do local é um caminho absoluto e não será consistente entre as máquinas. Você pode definir essa opção como verdadeira para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--[no]skyframe_state
padrão: "false"-
Sem realizar análises extras, despeja o gráfico de ação atual do Skyframe. Observação: No momento, não é possível especificar um destino com --skyframe_state. Essa sinalização 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 na "configuração exec" não serão incluídas no gráfico de dependência em que a consulta opera. Uma borda de dependência de "configuração de execução", como a de qualquer regra de "proto_library" para o Compilador de protocolos, normalmente aponta para uma ferramenta executada durante a versão, e não como parte de um mesmo programa de "destino".
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 destinos configurados que também estão na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração exec, somente destinos configurados por executivos serão retornados. Esta opção NÃO excluirá os conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino separados por vírgula (aditivo e subtrativo). A consulta pode ser realizada no universo definido pelo fechamento transitivo dos destinos especificados. Essa opção é usada para os comandos query e cquery.
Para cquery, a entrada para essa 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: se essa opção não for especificada, o build poderá corromper a compilação se os destinos analisados na expressão de consulta não forem criados com opções de nível superior.
Tags:loading_and_analysis
- Opções relacionadas à saída e à semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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 armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele será relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "false"-
Se é para fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Se as ações do manifesto de origem precisam ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel executará o pós-processamento de cobertura para teste em um novo spawn.
Tags:execution
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos tratarão todos os artefatos de saída como arquivos comuns. Eles não cruzam diretórios nem são sensíveis a links simbólicos.
Tags:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
padrão: ""-
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico da ação. Aplica-se apenas a ações compatíveis com informações de execução. Muitas ações comuns aceitam informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Ao especificar vários valores, a ordem é importante porque muitas regex podem se aplicar ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
".*=+x,.*=-y,.*=+z" adiciona "x" e "z" às informações de execução de todas as ações e remove "y".
"Genrule=+requires-x" adiciona "requires-x" às informações de execução para todas as ações da regra de regra.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são da Generule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Permita ações de dex e desugar permanentes do Android usando workers.
Expande-se para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ativa o processador de recursos permanente do Android usando workers.
Expande-se para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
{14/
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Permite ações dex e multiplex persistentes do Android usando workers.
Expande-se para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ativa o processador de recursos multiplexados persistentes do Android usando workers.
Expande-se 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
{14/
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Ativa ferramentas Android persistentes e multiplexadas (dexação, simplificação e processamento de recursos).
Expande-se para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel usará a plataforma de destino para executar testes em vez do grupo executivo de teste.
Tags:execution
- Opções que configuram o conjunto de ferramentas usado para a execução da ação:
- Padrão
--android_compiler=<a string>
: ver descrição -
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
padrão: "//external:android/crosstool"-
O local do compilador C++ usado para builds do Android.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--android_grte_top=<a label>
: ver descrição -
O destino Android grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para as regras android_binary. Sinalização para ajudar na transição do manifesto legado para a combinação do manifesto do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK multiarquitetura, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
padrão: "@bazel_tools//tools/android:sdk"-
Especifica o SDK/a plataforma Android usados para criar apps Android.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--apple_compiler=<a string>
: ver descrição -
O compilador de destino da Apple. Útil para selecionar variantes de um conjunto de ferramentas (por exemplo, xcode-beta).
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote crosstool a ser usado nas regras da Apple e Objc e as dependências delas.
Tags:loses_incremental_state
,changes_inputs
- Padrão
--apple_grte_top=<a build target label>
: ver descrição -
A segmentação da Apple grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
,explicit_in_output_path
- Padrão
--compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar os relatórios de cobertura brutos. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote entre ferramentas a ser usado para compilar o código C++.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--custom_malloc=<a build target label>
: ver descrição -
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de compilação.
Tags:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiplos foram acumulados-
Lista de expressões regulares separadas por vírgula, cada uma opcionalmente prefixada por - (expressão negativa), atribuída (=) a uma lista de segmentações de valores de restrição separados por vírgulas. Se um destino não corresponder a nenhuma expressão negativa e pelo menos uma expressão positiva, a resolução do conjunto de ferramentas será executada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 adicionará "x86_64" a qualquer destino em //demo, exceto para aqueles cujo nome contenha "test".
Tags:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
padrão: "true"-
Permite que as regras de objc_* dependam da cc_library e que qualquer dependência do objc seja criada com --cpu definido como "ios_<--ios_cpu>" para quaisquer valores em --ios_multi_cpu.
Tags:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definida, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão 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
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Caso verdadeiro, use o Xcode mais recente, disponível localmente e remotamente. Se for falso ou se não houver versões mútuas disponíveis, use a versão local do Xcode, selecionada via xcode-select.
Tags:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas disponíveis para execução de ações. As plataformas podem ser especificadas pelo destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores substituirão as configurações de sinalização anteriores.
Tags:execution
--extra_toolchains=<comma-separated list of options>
usos múltiplos foram acumulados-
As regras do conjunto de ferramentas a serem consideradas durante a resolução do conjunto de ferramentas. Os conjuntos de ferramentas podem ser especificados por destino exato ou como 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
- Padrão
--grte_top=<a label>
: ver descrição -
Um rótulo para uma biblioteca libc de entrada. O valor padrão é selecionado pelo conjunto de ferramentas de várias ferramentas, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para a compilação do host. Ela será ignorada se --host_crosstool_top não estiver definido.
Tags:loading_and_analysis
,execution
- Padrão
--host_crosstool_top=<a build target label>
: ver descrição -
Por padrão, as opções --crosstool_top e --compiler também são usadas na configuração exec. Se essa sinalização for fornecida, o Bazel usará a libc e o compilador padrão para o crosstool_top fornecido.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--host_grte_top=<a label>
: ver descrição -
Se especificada, esta configuração substitui o diretório de nível superior libc (--grte_top) para a configuração exec.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@local_config_platform//:host"-
O rótulo de uma regra de plataforma que descreve o sistema host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
padrão: "true"-
Se verdadeiro, o Bazel não permitirá especificar expand_if_all_available em flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não ativará os recursos "host" e "nonhost" no conjunto 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_android_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK do Android para regras do Android (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
padrão: "true"-
Se verdadeiro, o Bazel não reutilizará linhas de comando de ação de link C++ para linhas de comando de indexação lto. Consulte https://github.com/bazelbuild/bazel/issues/6791 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_linking_info_migration
padrão: "true"-
Se verdadeiro, as regras integradas do ObjC vão receber as informações de vinculação do CcInfo em vez do ObjcProvider. Veja mais detalhes e informações sobre a migração em https://github.com/bazelbuild/bazel/issues/16939
Tags:loading_and_analysis
,changes_inputs
eincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
padrão: "true"-
Se verdadeiro, o Bazel reclamará quando os atributos cc_toolchain.cpu e cc_toolchain.compiler forem definidos (consulte as instruções de migração em https://github.com/bazelbuild/bazel/issues/7075).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vinculará dependências de biblioteca como arquivo inteiro por padrão. Consulte https://github.com/bazelbuild/bazel/issues/7362 para ver instruções de migração.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
padrão: "true"-
Se verdadeiro, o Bazel exigirá o parâmetro "ctx" em cc_common.configure_features. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/7793.
Tags:loading_and_analysis
,incompatible_change
-
Use objetos compartilhados na interface se compatível com o conjunto de ferramentas. No momento, todos os conjuntos de ferramentas ELF são compatíveis com essa configuração.
Tags:loading_and_analysis
,affects_outputs
eaffects_outputs
- Padrão
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do iOS que será usada para criar aplicativos para iOS. Se não for especificado, usará a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do macOS que será usada para criar aplicativos para macOS. Se não for especificado, usará a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--minimum_os_version=<a string>
: ver descrição -
A versão mínima do sistema operacional que sua compilação segmenta.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais sinalizações definir quando já houver uma plataforma. Precisa ser relativo à raiz principal do espaço de trabalho. O padrão é "platform_mappings" (um arquivo diretamente abaixo da raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras de plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
- Padrão
--python2_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python3_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python_path=<a string>
: ver descrição -
O caminho absoluto do interpretador do Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--python_top=<a build target label>
: ver descrição -
O rótulo de um py_runtime que representa o interpretador de Python invocado para executar destinos em Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos tvOS. Se não for especificado, usará a versão padrão do SDK tvOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do watchOS que vai ser usada para criar apps watchOS. Se não for especificado, usará a versão padrão do SDK watchOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--xcode_version=<a string>
: ver descrição -
Se especificada, usa o Xcode da versão fornecida para ações de build relevantes. Se não for especificado, usará a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_enable_auto_dsym_dbg
padrão: "false"-
Se há força para ativar a geração de arquivos de símbolo de depuração (.dSYM) para builds do dbg.
Tags:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
padrão: "false"-
Se os arquivos de símbolos de depuração (.dSYM) serão gerados ou não.
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria runfiles symlink Forests para todos os destinos. Se for falso, escreva apenas manifestos quando possível.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de arquivos de execução para todos os destinos. Se falso, omiti-los. A execução dos testes locais falhará se ela for falsa.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao compilar testes de C++ estaticamente e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os prefixos dos arquivos principais criados por cc_proto_library.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os prefixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute mais ações para versões alternativas da API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
padrão: "false"-
Execute mais ações 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"-
Salvar o estado de recursos ativados e solicitados como uma saída de compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "não"-
Especifica quais modos de compilação usam a fissão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos arquivos de execução, o que corresponde ao comportamento recomendado para regras Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "true"-
Se for verdadeiro, crie florestas de links simbólicos para arquivos externos em repositórios .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se é necessário gerar um arquivo de linkmap.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), arquivos .i (C pré-processado) e arquivos .ii (C++ pré-processado).
Tags:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiplos foram acumulados-
Especifica o conjunto de variáveis de ambiente disponíveis para ações com a configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serão acumuladas.
Tags:action_command_lines
--android_cpu=<a string>
padrão: "armeabi-v7a"-
A CPU de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
padrão: "false"-
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso é usado apenas com a vinculação de dados v2.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "false"-
Use a vinculação de dados do Android v2 com o argumento 3.4.0
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"- Determina se dependências de C++ de regras do Android serão vinculadas dinamicamente quando um cc_binary não cria explicitamente uma biblioteca compartilhada. "padrão" significa que o Bazel escolherá a vinculação de forma dinâmica. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alfabético"-
Define a ordem dos manifestos transmitidos à combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação à 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 anterior aos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Crie o zip executável do Python. No Windows, desative em outras plataformas.
Tags:affects_outputs
--catalyst_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas 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 instrumentará o código (usando instrumentação off-line sempre que possível) e coletará informações de cobertura durante os testes. Apenas as segmentações que correspondem a --instrumentation_filter serão afetadas. Normalmente, essa opção não deve ser especificada diretamente. O comando "bazel cover" deve ser usado.
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
,explicit_in_output_path
--conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir para o GCC ao compilar arquivos de origem em C.
Tags:action_command_lines
,affects_outputs
--copt=<a string>
usos múltiplos foram acumulados-
Outras opções para passar para o GCC.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
,explicit_in_output_path
- Padrão
--cs_fdo_absolute_path=<a string>
: ver descrição -
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil bruto ou indexado do LLVM.
Tags:affects_outputs
- Padrão
--cs_fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação de 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 descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--cs_fdo_profile=<a build target label>
: ver descrição -
O cs_fdo_profile que representa o perfil sensível de contexto a ser usado para otimização.
Tags:affects_outputs
--cxxopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transferir para gcc ao compilar arquivos de origem em C++.
Tags:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
usos múltiplos foram acumulados-
Cada opção --define especifica uma atribuição para uma variável de versão.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados dinamicamente. "padrão" significa que o Bazel vinculará dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
padrão: "true"-
Se definido, o uso de fdo_absolute_profile_path gerará um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ativa a árvore de links simbólicos dos arquivos de execução. Por padrão, ela fica desativada no Windows e em outras plataformas.
Tags:affects_outputs
--experimental_action_listener=<a build target label>
usos múltiplos foram acumulados-
Obsoleto, substituído por aspectos. Use action_listener para anexar uma extra_action a ações de versão existentes.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compacte recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "false"-
Use a vinculação de dados do Android v2
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
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
usar a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,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 verdadeiro, use libunwind para liberar a pilha e compile com tabelas -fomit-frame-pointer e -fasynchronous-unwind.
Tags:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, a plataforma de destino é usada no nome do diretório de saída em vez da CPU.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificada, o Bazel gera informações do mapa de cobertura llvm-cov em vez de gcov quando a função collection_code_coverage está ativada.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated set of options>
padrão: "armeabi-v7a"-
Definir essa opção ativa APKs multiarquitetura, que contêm binários nativos para todas as arquiteturas de destino especificadas, por exemplo, --fat_apk_cpu=x86,armeabi-v7a. Se essa sinalização for especificada, --android_cpu será ignorado para dependências de regras android_binary.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
padrão: "false"-
Se quer criar divisões HWASAN.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--fdo_optimize=<a string>
: ver descrição -
Use as informações do perfil do FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP contendo uma árvore de arquivos .gcda, um arquivo afdo que contenha um perfil automático ou um arquivo de perfil LLVM. Essa sinalização também aceita arquivos especificados como marcadores (por exemplo, `//foo/bar:file.afdo` - pode ser necessário adicionar uma diretiva `exports_files` ao pacote correspondente) e marcadores apontando para destinos `fdo_profile`. Essa sinalização será substituída pela regra "fdo_profile".
Tags:affects_outputs
- Padrão
--fdo_prefetch_hints=<a build target label>
: ver descrição -
Use as dicas de pré-busca de cache.
Tags:affects_outputs
- Padrão
--fdo_profile=<a build target label>
: ver descrição -
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
--features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão nos destinos criados na configuração deles. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Veja também --host_features
Tags:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ produzem código independente de posição ("-fPIC"), os links preferem bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e links 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>
usos múltiplos foram 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á obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serã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 integradas. Valores: 'fastbuild', 'dbg', 'opt'.
Tags:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir ao compilador C ao compilar arquivos de origem em C, mas não em C++, nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_copt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C as ferramentas criadas nas configurações exec.
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>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C++ as ferramentas criadas nas configurações exec.
Tags:action_command_lines
,affects_outputs
--host_features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão para os destinos criados na configuração exec. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
- Padrão
--host_force_python=<PY2 or PY3>
: ver 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>
usos múltiplos foram acumulados-
Outra opção para transmitir ao vinculador ao vincular ferramentas nas configurações exec.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações do executivo. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da linha de comando -O0 à linha de comando gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir um arquivo swiftc a ferramentas exec.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo executivo é criado automaticamente para cada conjunto de ferramentas usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro `toolchain` em suas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_avoid_conflict_dlls
padrão: "true"-
Se ativado, todas as bibliotecas dinâmicas dinâmicas C++ (DLLs, na sigla em inglês) geradas por cc_library no Windows serão renomeadas como name_{hash}.dll, em que o hash é calculado com base no nome do repositório e no caminho do pacote da DLL. Essa opção é útil quando você tem um pacote que depende de vários cc_library com o mesmo nome (por exemplo, //foo/bar1:utils e //foo/bar2:utils).
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório "genfiles" será dobrado no diretório "bin".
Tags:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
padrão: "false"-
Se for verdadeiro, use --features apenas para a configuração de destino e --host_features para a configuração exec.
Tags:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação das regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. Caso contrário, as regras de teste sempre serão 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 estiver ativada, somente as regras com nomes incluídos pelo filtro com base em regex especificado serão instrumentadas. As regras com o prefixo "-" são excluídas. Apenas regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
- Padrão
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar um ios_application. O resultado é um binário universal contendo todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Obsoleto, substituído por --compatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para mais detalhes). Quando ativado, use --whole-archive para as regras cc_binary que têm linkshared=True e linkstatic=True ou '-static' em linkopts. Isso se aplica apenas à compatibilidade com versões anteriores. Uma alternativa melhor é usar "semprelink=1" quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para passar para o GCC durante a vinculação.
Tags:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de back-end LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de indexação da LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se ela estiver definida e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Se é necessário remover símbolos ou códigos inativos nos binários vinculados. As remoções binárias serão executadas se essa sinalização e --compile_mode=opt forem especificadas.
Tags:action_command_lines
--objccopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir 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>
usos múltiplos foram acumulados-
Outras opções para passar seletivamente ao GCC ao compilar determinados arquivos Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao back-end de LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter representa uma lista de padrões para incluir e excluir expressões regulares. option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 -O0 à linha de comando do back-end LTO de todos os arquivos em //foo/ exceto bar.o.
Tags:action_command_lines
,affects_outputs
- Padrão
--platform_suffix=<a string>
: ver descrição -
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Padrão
--propeller_optimize=<a build target label>
: ver descrição -
Use as informações do perfil da hélice para otimizar o destino da versão.Um perfil de hélice precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Esse sinalizador aceita um rótulo de compilação que deve se referir aos arquivos de entrada do perfil de hélice. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva export_files pode precisar ser adicionada ao pacote correspondente para tornar esses arquivos visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
- Padrão
--propeller_optimize_absolute_cc_profile=<a string>
: ver descrição -
O nome absoluto do caminho do arquivo cc_profile para builds do Propeller Optimized.
Tags:affects_outputs
- Padrão
--propeller_optimize_absolute_ld_profile=<a string>
: ver descrição -
Nome absoluto do caminho do arquivo ld_profile para builds otimizados para a hélice.
Tags:affects_outputs
- Padrão
--run_under=<a prefix in front of command>
: ver 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".Ela também pode ser um rótulo para um destino executável. Alguns exemplos são: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tags:action_command_lines
-
Se for verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Marque os binários com data, nome de usuário, nome do host, informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se é necessário remover binários e bibliotecas compartilhadas (usando "-Wl,--strip-debug"). O valor padrão de "às vezes" significa strip iff --compile_mode=fastbuild.
Tags:affects_outputs
--stripopt=<a string>
usos múltiplos foram acumulados-
Opções adicionais a serem transmitidas para a faixa ao gerar um binário "<name>.stripped".
Tags:action_command_lines
,affects_outputs
--swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir para a compilação do Swift.
Tags:action_command_lines
--tvos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar binários do tvOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Versão mínima do tvOS compatível para simuladores e dispositivos de destino. Se não for especificado, usará 'tvos_sdk_version'.
Tags:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgula para as quais criar binários watchOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
- Padrão
--xbinary_fdo=<a build target label>
: ver descrição -
Use as informações do perfil 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 como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--auto_cpu_environment_group=<a build target label>
padrão: ""-
Declare o ambiente_grupo a ser usado para mapear automaticamente os valores de CPU para os valores de "target_environment".
Tags:changes_inputs
,loading_and_analysis
,experimental
--[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 em dependências de destino são rebaixados a avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Se quer simplificar o bytecode Java 8 antes da dexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Inclui se as bibliotecas Java 8 compatíveis serão incluídas nos apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com os quais cada destino é compatível e relata erros se algum destino tiver dependências que não são compatíveis com os mesmos ambientes
Tags:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
padrão: "false"-
Sinaliza para ajudar na transição de permitir a não permitir regras android_library sem src com dependências. É necessário limpar o armazenamento para que ele seja implantado por padrão.
Tags:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
padrão: "true"-
Se deve verificar a simplificação correta no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
padrão: "DESATIVADO"-
Quando ativada, verifique se as dependências de um aar_import estão completas. Essa aplicação pode corromper a versão ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se a opção estiver ativada, verifique somente os destinos de pré-requisito que são arquivos de saída procurando a regra de teste somente da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações do conjunto 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 Android do Starlark em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Ambiente autônomo. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
padrão: "true"-
Se ativada, defina a verificação de cabeçalho rígida nas APIs Starlark
Tags:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 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]incompatible_validate_top_level_header_inclusions
padrão: "true"-
Se verdadeiro, o Bazel também validará as inclusões de cabeçalho de diretório de nível superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para mais informações).
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_native_rules_allowlist=<a build target label>
: ver descrição - Uma lista de permissões (destino de group_group) a ser usada ao aplicar --compatible_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 relatados como erros. Ele não funciona quando check_fileset_dependencies_recursively está desativado.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em 'importar público' como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados pelo sistema incluem caminhos (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
usos múltiplos foram acumulados-
Declara o ambiente de destino dessa versão. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido, e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
- Padrão
--ios_signing_cert_name=<a string>
: ver descrição -
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado novamente. Pode ser a preferência de identidade do conjunto de chaves do certificado ou (substring) do nome comum do certificado, conforme a página do manual do signo (SIGNING IDENTITIES).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, .bzl ou WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
O ambiente autônomo será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permite os atributos sdk_frameworks e fraca_sdk_frameworks em objc_library andobjc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, torne o valor padrão verdadeiro para os atributos sempre do link em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, ocorre um erro ao usar as regras py_* integradas. Em vez disso, use as regras rule_python. Consulte https://github.com/bazelbuild/bazel/issues/17773 para ver 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 verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo que contém a descrição do erro, em vez de resultar em uma falha de versão.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas por meio de um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite resultará em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiras falhas de ação do dex2oat causarem falha na compilação em vez de executar o dex2oat durante o tempo de execução de teste.
Tags:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para possivelmente acelerar android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória nos destinos ios_test.
Tags:action_command_lines
- Padrão
--ios_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do iOS que será executada no simulador durante a execução ou teste. Isso será ignorado em regras de 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>
usos múltiplos foram acumulados- Especifica o número de vezes que o teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, todo o teste será considerado com falha. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 executará todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Onde run_per_test representa o valor inteiro e regex_filter representa uma lista de padrões para incluir e excluir expressões regulares (também consulte --instrumentation_filter). Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto os que estão em foo/bar três vezes. Essa opção pode ser passada várias vezes. O argumento passado 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>
usos múltiplos foram acumulados-
Especifica outras variáveis de ambiente a serem injetadas no ambiente de execução do teste. As variáveis podem ser especificadas por nome, caso em que seu valor será lido no ambiente de cliente do Bazel ou pelo par name=value. Essa opção pode ser usada várias vezes para especificar diversas 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 para testes (em segundos). Se um único valor inteiro positivo for especificado, ele substituirá todas as categorias. Se forem especificados quatro números inteiros separados por vírgula, eles substituirão os limites de tempo curto, moderado, longo e eterno (nessa ordem). Em qualquer formato, o valor -1 instrui o blaze a usar seus tempos limite padrão para essa categoria.
- Padrão
--tvos_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo tvOS no simulador, por exemplo, "Apple TV 1080p". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do tvOS a ser executada no simulador durante a execução ou teste.
Tags:test_runner
- Padrão
--watchos_simulator_device=<a string>
: ver descrição -
O dispositivo que será simulado ao executar um aplicativo watchOS no simulador, por exemplo, "Apple Watch - 38 mm". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do watchOS para execução no simulador durante a execução ou teste.
Tags:test_runner
--[no]zip_undeclared_test_outputs
padrão: "true"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções relacionadas à saída e à semântica da consulta:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é {xml,proto,record}. "off" significa que nenhuma dependência de aspectos é resolvida, "conservadora" (o padrão) significa que todas as dependências declaradas são adicionadas, independentemente de terem recebido a classe de regra de dependências diretas, "preciso" significa que apenas os aspectos que são possivelmente ativos são adicionados, possivelmente dada a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, tornando-o mais lento do que os outros modos. Observe também que o modo preciso não é completamente preciso: a decisão de computar um aspecto é decidida na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]deduplicate_depsets
padrão: "true"-
Eliminar a duplicação de filhos não folhas de um dep_set_of_files na saída proto/textproto/json final. Isso não elimina as dependências que não compartilham um pai imediato. Isso não afeta a lista efetiva de artefatos de entrada das ações.
Tags:terminal_output
--[no]experimental_parallel_aquery_output
padrão: "false"- Se a saída proto/textproto da consulta precisa ser gravada em paralelo. Ambiente autônomo para os outros formatos de saída.
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido " fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos deles serão concatenados. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O tamanho máximo da string de rótulo para um nó de gráfico na saída. Marcadores mais longos ficarão truncados. -1 significa sem truncamento. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita é aquela que não está explicitamente especificada no arquivo BUILD, mas adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--[no]include_artifacts
padrão: "true"-
Inclui nomes das entradas e saídas de ação na saída (possivelmente grande).
Tags:terminal_output
--[no]include_aspects
padrão: "true"- aquery, cquery: se serão incluídas ações geradas por aspecto na saída. query: no-op (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 (possivelmente grande).
Tags:terminal_output
--[no]include_file_write_contents
padrão: "false"-
Inclua o conteúdo do arquivo para as ações FileWrite e SourceSymlinkManifest (possivelmente grande).
Tags:terminal_output
--[no]include_param_files
padrão: "false"-
Inclua o conteúdo dos arquivos de parâmetros usados no comando (possivelmente grande). Observação: ativar essa sinalização ativará automaticamente a sinalização --include_commandline.
Tags:terminal_output
--[no]incompatible_display_source_file_location
padrão: "true"-
Verdadeiro por padrão, mostra o destino do arquivo de origem. Se verdadeiro, exibe o local da linha 1 dos arquivos de origem nas saídas do local. Essa sinalização existe apenas para fins de migração.
Tags:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo `packages` do package_group, o `//` principal não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se "set" e "-universe_scope" não forem definidos, um valor de "--verse" será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo universal (por exemplo, `allrdeps`) pode não ser o que você quer. Portanto, use essa opção apenas se souber o que está fazendo. Consulte 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: esta opção se aplica somente a "consulta" (ou seja, não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Se cada formato é terminado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativada, as dependências dos atributos "nodep" serão incluídas no gráfico de dependência em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de compilação.
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 uma consulta são: text, textproto, proto, stream_proto, jsonproto.
Tags:terminal_output
--[no]proto:default_values
padrão: "true"-
Se verdadeiro, os atributos com valor não especificado explicitamente no arquivo BUILD são incluídos. Caso contrário, são omitidos. Essa opção é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto define_stack, que registra para cada instância de regra a pilha de chamadas Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativada, os atributos configuráveis criados por select() são simplificados. Para tipos de lista, a representação nivelada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulo.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo do proto source_aspect_name de cada Atributo com o aspecto de origem do atributo (string vazia se não tiver sido).
Tags:terminal_output
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Calcular ou não o atributo $internal_attr_hash.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Se é preciso enviar informações de local na saída proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "todos"-
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 é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Se os campos regra_entrada e regra_saída serão ou não preenchidos.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definida, a consulta lerá a consulta no arquivo chamado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, a localização dos arquivos BUILD em saídas xml e proto será relativa. Por padrão, a saída do local é um caminho absoluto e não será consistente entre as máquinas. Você pode definir essa opção como verdadeira para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--[no]skyframe_state
padrão: "false"-
Sem realizar análises extras, despeja o gráfico de ação atual do Skyframe. Observação: No momento, não é possível especificar um destino com --skyframe_state. Essa sinalização 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 na "configuração exec" não serão incluídas no gráfico de dependência em que a consulta opera. Uma borda de dependência de "configuração de execução", como a de qualquer regra de "proto_library" para o Compilador de protocolos, normalmente aponta para uma ferramenta executada durante a versão, e não como parte de um mesmo programa de "destino".
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 destinos configurados que também estão na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração exec, somente destinos configurados por executivos serão retornados. Esta opção NÃO excluirá os conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino separados por vírgula (aditivo e subtrativo). A consulta pode ser realizada no universo definido pelo fechamento transitivo dos destinos especificados. Essa opção é usada para os comandos query e cquery.
Para cquery, a entrada para essa 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: se essa opção não for especificada, o build poderá corromper a compilação se os destinos analisados na expressão de consulta não forem criados com opções de nível superior.
Tags:loading_and_analysis
- Opções que acionam otimizações do tempo de compilação:
--[no]collapse_duplicate_defines
padrão: "true"-
Quando ativada, a opção --defines é removida no início da versão. Isso evita a perda desnecessária do cache de análise para determinados tipos de builds equivalentes.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProGuard ProgramJar para remover todas as classes que também estão no LibraryJar.
Tags:action_command_lines
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativado, os arquivos .d de C++ serão transmitidos na memória diretamente dos nós do build remoto em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados pelas compilações em Java serão transmitidos na memória diretamente dos nós de compilação remota, em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
padrão: "false"-
Realize a verificação de inclusão para C/C++ objetivo.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativada, --trim_test_configuration não cortará a configuração de teste das regras marcadas como testonly=1. Isso visa reduzir problemas de conflito de ação quando as regras não relacionadas a teste dependem das regras cc_test. Nenhum efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import pode ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Para refinar as entradas para a compilação C/C++ analisando #include linhas dos arquivos de entrada. Isso pode melhorar o desempenho e a incrementabilidade diminuindo o tamanho das árvores de entrada de compilação. No entanto, ela também pode corromper 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. Qualquer problema relacionado a este sinalizador que será registrado será encerrado.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
padrão: "true"-
Faz a maior parte do trabalho de dexação separadamente para cada arquivo Jar.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para remover 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 dos quais //a:a depende (se o processamento do cabeçalho estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativadas, as opções relacionadas a testes serão limpas abaixo do nível superior do build. Quando essa sinalização está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as alterações nas opções relacionadas a testes não farão com que as regras que não são de teste sejam analisadas novamente.
Tags:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
padrão: "true"-
Esta opção está obsoleta. Agora é um ambiente autônomo e será removido em breve.
Tags:loading_and_analysis
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Imprimir informações de depuração durante a resolução do conjunto de ferramentas. A sinalização usa um regex, verificado em relação aos tipos de conjunto de ferramentas e a destinos específicos para ver qual depurar. Várias regex podem ser separadas por vírgulas e, em seguida, cada regex é verificado separadamente. Observação: a saída dessa sinalização é muito complexa e provavelmente será útil apenas para especialistas na resolução de conjuntos de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias:
--flag_alias=<a 'name=value' flag alias>
usos múltiplos foram acumulados-
Define um nome abreviado para uma sinalização do Starlark. Ele usa um único par de chave-valor no formato "<key>=<value>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa sinalização altera o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos arquivos de execução dos destinos Python. Exatamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa sinalização estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 aparecerão em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 aparecerão em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico "bazel-bin" apontará para os destinos do Python 3 em vez do Python 2. Se você ativar esta opção, também será recomendável ativar `--compatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") são definidos como PY3, em vez de PY2. Se você definir essa sinalização, também será recomendável definir `--compatible_py2_outputs_are_suffixed`.
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como verdadeiro, as regras nativas do Python nativo usarão o ambiente de execução do Python especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução indicado por sinalizações legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_version=<PY2 or PY3>
: ver descrição -
O modo de versão principal do Python, `PY2` ou `PY3`. Ele é substituído por destinos `py_binary` e `py_test` (mesmo que eles não especifiquem explicitamente uma versão). Geralmente, não há muito motivo para fornecer essa sinalização.
Tags:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opções diversas, não categorizadas de outra forma:
--[no]cache_test_results
[-t
] padrão: "auto"- Se esta configuração for definida como "auto", o Bazel executará um teste novamente se e somente se: (1) o Bazel detectar alterações no teste ou as dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de testes, exceto os marcados como externos. Se definido como "não", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze cancelará os testes em execução simultânea na primeira execução bem-sucedida. Isso é útil apenas em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca todo o diretório de dados de cobertura para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do Clang gerará um relatório de LCOV.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
padrão: "true"- Gera o mapa de cabeçalho J2ObjC em paralelo com a transcompilação J2ObjC.
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Gerar com caminho de cabeçalho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Ativa caminhos de classe reduzidos para compilações em Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Limite --experimental_run_android_lint_on_java_rules a bibliotecas compatíveis com Android.
Tags:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Valida ou não as origens de java_*.
Tags:affects_outputs
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência para JUnit ou Hamcrest em um java_test, em vez de receber acidentalmente das dependências do TestRunner. No momento, só funciona com o Bazel.
- Padrão
--host_java_launcher=<a build target label>
: ver descrição - A tela de início do Java usada por ferramentas que são executadas durante uma versão.
--host_javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac ao criar ferramentas executadas durante uma compilação.
--host_jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java ao criar ferramentas executadas durante a criação. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel falhará em um teste fragmentado se o executor não indicar que ele é compatível com a fragmentação, tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se falso, um executor de teste que não suporta a fragmentação levará a todos os testes em execução em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia no modo sandbox. Adicione a tag "local" para forçar uma execução exclusiva de um teste local.
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
usos múltiplos foram acumulados- Outras opções para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde a conexão de um depurador compatível com JDWP (como jdb) antes de iniciar o teste. Implica -test_output=streamed.
Expande-se para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gere informações de dependência (por enquanto, classpath no tempo de compilação) por destino em 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
- Padrão
--java_launcher=<a build target label>
: ver descrição - A tela de início do Java a ser usada ao criar binários do Java. Se essa sinalização for definida como a string vazia, a tela de início do JDK será usada. O atributo "launcher" substitui essa sinalização.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução do Java
--javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac.
--jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
- Padrão
--legacy_main_dex_list_generator=<a build target label>
: ver descrição - Especifica um binário para gerar a lista de classes que precisam estar no dex principal ao compilar multidex legado.
- Padrão
--optimizing_dexer=<a build target label>
: ver descrição - Especifica um binário para ser usado na dexação sem fragmentação.
--plugin=<a build target label>
usos múltiplos foram acumulados- Plug-ins a serem usados no build. Atualmente, funciona com java_plugin.
- Padrão
--proguard_top=<a build target label>
: ver descrição - Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do proto-compilador.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos de C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do Java.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags:affects_outputs
,loading_and_analysis
--protocopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa passe e pelo menos uma execução/tentativa falhe terá um status FLAKY.
- Padrão
--shell_executable=<a path>
: ver descrição -
O caminho absoluto para o executável do shell a ser usado pelo Bazel. Se não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor), ele a usará. Se nenhum deles estiver definido, o Bazel usará um caminho padrão codificado, dependendo do sistema operacional em que for executado (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). Observe que o uso de um shell não compatível com bash pode causar falhas de compilação ou falhas de tempo de execução nos binários gerados.
Tags:loading_and_analysis
--test_arg=<a string>
usos múltiplos foram acumulados- Especifica outras opções e argumentos que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles receberá argumentos idênticos. Usado apenas pelo comando "bazel test".
- Padrão
--test_filter=<a string>
: ver descrição - Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução de testes. Isso não afeta quais destinos são criados.
--test_result_expiration=<an integer>
padrão: "-1"- Esta opção está obsoleta e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- A opção de encaminhamento falha com rapidez para o executor de teste. O executor de testes deve parar 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: "explícito"- Especifique a estratégia de fragmentação de teste: "explícito" para usar fragmentação apenas se o atributo "BUILD" de "shard_count" estiver presente. "disabled" para nunca usar fragmentação de teste. 'forced=k' para impor os fragmentos 'k' para teste, independentemente do atributo 'shard_count' do BUILD.
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante uma compilação.
--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 a criação
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso resultará em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de build
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--[no]check_up_to_date
padrão: "false"-
Não execute o build. Apenas verifique se ele está atualizado. Se todos os destinos estiverem atualizados, a versão será concluída. Se alguma etapa precisar ser executada, um erro será relatado e a compilação falhará.
Tags:execution
--dynamic_local_execution_delay=<an integer>
padrão: "1000"-
Quantos milissegundos a execução local deve atrasar, se a execução remota foi mais rápida durante uma versão pelo menos uma vez?
Tags:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiplos foram acumulados-
As estratégias locais a serem usadas em um mnemônico específico. A primeira estratégia aplicável é usada. Por exemplo, "worker,sandboxed" executa ações que aceitam workers persistentes que usam a estratégia de workers e todas as outras que usam a estratégia em sandbox. Se nenhum mnemônico é fornecido, a lista de estratégias é usada como substituta para todos os elementos mnemônicos. A lista de fallback padrão é `worker,sandboxed` ou `worker,sandboxed,standalone` se "experimental_local_lockfree_output" estiver definido. Toma [mnemonic=]local_strategy[,local_strategy,...]
Tags:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiplos foram acumulados-
As estratégias remotas, para serem usadas em um mnemônico específico. É usada a primeira estratégia aplicável. Se nenhum mnemônico é fornecido, a lista de estratégias é usada como substituta para todos os elementos mnemônicos. A lista de substitutos padrão é `remote`. Portanto, essa sinalização geralmente não precisa ser definida explicitamente. Toma [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 deve ser usado para executar uma ação no modo sandbox ao usar a estratégia do Docker. A ação em si ainda não tem um atributo de imagem de contêiner em remote_execution_properties na descrição da plataforma. O valor dessa sinalização é transmitido ao pé de "docker run". Portanto, ele suporta a mesma sintaxe e mecanismos que o próprio Docker.
Tags:execution
--[no]experimental_docker_use_customized_images
padrão: "true"-
Se ativada, injeta o uid e o gid do usuário atual na imagem do Docker antes de usá-la. Isso é necessário se sua versão / testes depender do usuário ter um nome e um diretório inicial no contêiner. Essa opção fica ativada por padrão, mas você pode desativá-la caso o recurso de personalização automática de imagens não funcione no seu caso ou você saiba que não precisa dela.
Tags:execution
--[no]experimental_dynamic_exclude_tools
padrão: "true"-
Quando definidos, os destinos criados "para ferramenta" não estão sujeitos à execução dinâmica. É improvável que esses destinos sejam construídos de forma incremental e, portanto, não vale a pena gastar ciclos locais.
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 para colocar na máquina local. Essa sinalização ajusta quantas ações na execução dinâmica serão programadas simultaneamente. Ele é baseado no número de CPUs que o Blaze considera disponíveis, que podem ser controladas com a sinalização --local_cpu_resources.
Se essa sinalização for 0, todas as ações serão programadas localmente imediatamente. Se for > 0, a quantidade de ações programadas localmente será limitada pelo número de CPUs disponíveis. Se for menor que 1, o fator de carga será usado para reduzir o número de ações programadas localmente quando o número de ações que aguardam a programação for alto. Isso diminui a carga na máquina local no caso de compilação limpo, em que a máquina local não contribui muito.
Tags:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
padrão: "0"-
Se for > 0, o tempo em que uma ação de execução dinâmica 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 esse recurso sem monitorar problemas de execução remota.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
padrão: "false"-
Ativar o sandbox baseado em Docker. Essa opção não terá efeito se o Docker não estiver instalado.
Tags:execution
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
padrão: "0"-
Se for 0, exclua as árvores do sandbox assim que uma ação for concluída (causando a conclusão da ação a ser atrasada). Se for maior que zero, execute a exclusão desses três em um pool de linhas de execução assíncrona que tenha tamanho 1 quando a versão estiver em execução e cresça para o tamanho especificado por essa sinalização quando o servidor estiver inativo.
Tags:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
padrão: "0"-
Se for maior que zero, cada sandbox do Linux será limitado à quantidade especificada de memória (em MB). Requer os cgroups v1 ou v2 e permissões para os usuários para o diretório cgroups.
Tags:execution
--experimental_sandboxfs_path=<a string>
padrão: "sandboxfs"-
Caminho para o binário do sandboxf a ser usado quando --experimental_use_sandboxfs for verdadeiro. Se for um nome simples, use o primeiro binário desse nome encontrado no PATH.
Tags:host_machine_resource_optimizations
,execution
--[no]experimental_shrink_worker_pool
padrão: "false"-
Se ativada, poderá reduzir o pool de workers se a pressão da memória do worker estiver alta. Esta sinalização só funciona quando a experimental experimental_total_worker_memory_limit_mb está ativada.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
padrão: "true"-
Se essa sinalização for 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 que contém o registro de teste. Caso contrário, o Bazel 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 ociosos poderão ser eliminados se o uso total da 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 ativar a raiz, ativar apenas o que é fornecido com sandbox_add_mount_pair. Os arquivos de entrada serão vinculados ao sandbox em vez de vinculados do sandbox. Se os arquivos de entrada de ação estiverem localizados em um sistema de arquivos diferente do sandbox, os arquivos de entrada serão copiados.
Tags:execution
--[no]experimental_use_sandboxfs
padrão: "false"-
Use o sandboxfs para criar os diretórios execroot das ações em vez de criar uma árvore de links simbólicos. Se for "sim", o binário fornecido pelo --experimental_sandboxfs_path precisa ser válido e corresponder a uma versão compatível do sandboxfs. Se for "auto", talvez o binário esteja ausente ou não seja compatível.
Tags:host_machine_resource_optimizations
,execution
--[no]experimental_use_semaphore_for_jobs
padrão: "false"-
Se definido como verdadeiro, use também o semaphore 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 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", talvez o binário esteja ausente ou não seja compatível.
--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.
- Padrão
--experimental_worker_allowlist=<comma-separated set of options>
: ver descrição -
Se não estiver vazio, só permitir o uso de workers persistentes com o mnemônico da chave de worker especificada.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_worker_as_resource
padrão: "true"-
O ambiente autônomo será removido em breve.
Tags:no_op
--[no]experimental_worker_cancellation
padrão: "false"-
Se ativado, o Bazel pode enviar solicitações de cancelamento aos workers compatíveis.
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 eliminados se o uso da memória do worker exceder o limite. Se não for usado junto com a execução dinâmica e "--experimental_dynamic_ignore_local_signals=9", isso poderá causar uma falha na compilação.
Tags:execution
,host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
padrão: "5s"-
O intervalo entre a coleta de métricas do worker e, possivelmente, as remoções. Não pode efetivamente ser menor que 1 segundo por motivos de desempenho.
Tags:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
padrão: "false"-
Se ativado, os workers multiplex serão colocados no sandbox, usando um diretório de sandbox separado por solicitação de trabalho. Apenas workers que tenham o requisito de execução "supports-multiplex-sandboxing" serão colocados no sandbox.
Tags:execution
--[no]experimental_worker_strict_flagfiles
padrão: "false"-
Se ativado, os argumentos de ações para workers que não seguirem a especificação do worker causarão um erro. Os argumentos do worker precisam ter exatamente um argumento @flagfile como o último da lista de argumentos.
Tags:execution
--genrule_strategy=<comma-separated list of options>
padrão: ""-
Especifique como executar regras gerais. Esta sinalização será descontinuada. Use --spawn_strategy=<value> para controlar todas as ações ou --strategy=Genrule=<value> para controlar apenas regras gerais.
Tags:execution
--high_priority_workers=<a string>
usos múltiplos foram acumulados-
O ambiente autônomo será removido em breve.
Tags:execution
--[no]incompatible_remote_dangling_symlinks
padrão: "true"-
Se definido como verdadeiro e --compatible_remote_symlinks também for verdadeiro, os links simbólicos nas saídas de ação poderão ficar suspensos.
Tags:execution
,incompatible_change
--[no]incompatible_remote_symlinks
padrão: "true"-
Se definido como verdadeiro, o Bazel representará links simbólicos em saídas de ação no protocolo remoto de armazenamento em cache/execução como tal. Caso contrário, os links simbólicos serão seguidos e representados como arquivos ou diretórios. Consulte #6631 para obter detalhes.
Tags:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
padrão: "false"-
Se definido como verdadeiro, cada sandbox do Linux terá o próprio diretório dedicado dedicado como /tmp em vez de compartilhar /tmp com o sistema de arquivos do host. Use --sandbox_add_mount_pair=/tmp para continuar vendo o /tmp do host em todos os sandboxes.
Tags:execution
--[no]internal_spawn_scheduler
padrão: "false"-
Opção de marcador para que possamos dizer ao 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. Toma 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 que falhou e os 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 para a fase de carregamento/análise.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" 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: "false"-
Se definido como verdadeiro, os diretórios usados pela execução fora do worker no sandbox poderão ser reutilizados para evitar custos desnecessários de configuração.
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 possivelmente melhorar muito o desempenho quando a versão / teste tiver muitos arquivos de entrada. Observação: você precisa de RAM e espaço livre suficiente no tmpfs para manter os arquivos intermediários e de saída gerados pelas ações em execução.
Tags:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
padrão: "false"-
Ativa explicitamente a criação de pseudoterminais para ações em sandbox. Algumas distribuições Linux exigem a configuração do ID do grupo do processo para "tty" dentro da sandbox, para que os pseudoterminais funcionem. Se isso estiver causando problemas, essa sinalização poderá ser desativada para permitir que outros grupos sejam usados.
Tags:execution
--sandbox_tmpfs_path=<an absolute path>
usos múltiplos foram acumulados-
Para ações no sandbox, ative um diretório vazio e gravável neste caminho absoluto (se compatível com a implementação do sandbox, ignorado caso contrário).
Tags:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
padrão: "false"-
Ignore destinos incompatíveis que estejam explicitamente listados na linha de comando. Por padrão, criar esses destinos resulta em um erro, mas eles são ignorados quando essa opção está ativada. Consulte: https://bazel.build/extending/platforms#skipping-compatible-targets
Tags:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
padrão: ""-
Especifique como as ações de geração são executadas por padrão. Aceita uma lista de estratégias separadas por vírgulas, da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a prioridade mais alta que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Veja mais detalhes em https://blog.bazel.build/2019/06/19/list-strategy.html.
Tags:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiplos foram acumulados-
Especifique como distribuir a compilação de outras ações de spawn. Aceita uma lista de estratégias separadas por vírgulas, da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a prioridade mais alta que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Essa sinalização modifica os valores definidos por --spawn_strategy (e --genrule_strategy se usados com mnemônico Genrule). Veja mais detalhes em https://blog.bazel.build/2019/06/19/list-strategy.html.
Tags:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiplos foram acumulados-
Substitui qual estratégia de geração é usada para executar ações de spawning com descrições correspondentes a um determinado regex_filter. Consulte --per_file_copt para obter detalhes sobre a correspondência de regex_filter. O último regex_filter que corresponde à descrição é usado. Essa opção substitui outras sinalizações 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 executará "Compilação //foo/bar/baz" com a estratégia "local", mas reverter a ordem a executaria com "sandboxed".
Tags:execution
--worker_extra_flag=<a 'name=value' assignment>
usos múltiplos foram acumulados-
Sinalizações de comando extras que serão passadas para processos de trabalho, além de --persistent_worker, codificadas 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">
usos múltiplos foram acumulados-
Quantas instâncias de cada tipo de worker permanente 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 em mnemônicas, mas também nas sinalizações e no ambiente de inicialização. Portanto, em alguns casos, pode haver mais workers por mnemônico do que essa sinalização especifica. Toma 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ônicas não especificadas.
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">
usos múltiplos foram acumulados-
Quantas WorkRequests um processo multiplex de trabalho pode receber em paralelo se você usar a estratégia "worker" com --experimental_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 em mnemônicas, mas também nas sinalizações e no ambiente de inicialização. Portanto, em alguns casos, pode haver mais workers por mnemônico do que essa sinalização especifica. Toma 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ônicas não especificadas.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
padrão: "true"-
Se ativado, os workers usarão a multiplexação caso sejam compatíveis.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
padrão: "false"-
Se ativada, todos os workers são encerrados depois que uma versão é concluída.
Tags:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
padrão: "false"-
Se ativado, os workers serão executados em um ambiente de sandbox.
Tags:execution
--[no]worker_verbose
padrão: "false"- Se ativada, imprime mensagens detalhadas quando os workers são iniciados, encerram...
- Opções que configuram o conjunto de ferramentas usado para a execução da ação:
--[no]incompatible_disable_runtimes_filegroups
padrão: "false"-
O ambiente autônomo foi descontinuado.
Tags:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
padrão: "true"-
O ambiente autônomo foi descontinuado.
Tags:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
padrão: "true"-
O ambiente autônomo foi descontinuado.
Tags:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--target_platform_fallback=<a string>
padrão: ""-
Esta opção está obsoleta e não tem efeito.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
- 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 compilação pare antes de executar as ações dela, retornando zero se as fases de carregamento e análise do pacote tiverem sido concluídas com êxito. Este modo é útil para testar essas fases.
Tags:execution
,affects_outputs
--[no]experimental_run_validations
padrão: "true"-
Use --run_validations.
Tags:execution
,affects_outputs
--[no]experimental_use_validation_aspect
padrão: "false"-
Executar ações de validação usando aspecto (para paralelismo com testes).
Tags:execution
,affects_outputs
--output_groups=<comma-separated list of options>
usos múltiplos foram acumulados-
Uma lista de nomes de grupos de saída separados por vírgulas, cada um opcionalmente prefixado com 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 for prefixado, o conjunto padrão de grupos de saída será omitido. Por exemplo, --output_groups=+foo,+bar constrói a união do conjunto padrão, foo e bar, enquanto --output_groups=foo,bar modifica o conjunto padrão de forma que apenas foo e bar sejam criados.
Tags:execution
,affects_outputs
--[no]run_validations
padrão: "true"-
Se é para executar ações de validação como parte do build. Consulte https://bazel.build/extending/rules#validation_actions
Tags:execution
,affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando seu valor, em vez da existência dela:
--aspects=<comma-separated list of options>
usos múltiplos foram acumulados- Lista separada por vírgulas de aspectos a serem aplicados a metas de nível superior. Na lista, se some_aspect especificar os provedores de aspecto necessários por meio dos required_aspect_providers, alguns_aspect serão executados depois de cada aspecto mencionado antes na lista, cujos provedores anunciados atendem a alguns_provedores de aspecto obrigatórios. Além disso, some_aspect será executado depois de todos os aspectos obrigatórios especificados por exigir atributo. 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 do artefato BEP.
Tags:affects_outputs
--[no]experimental_convenience_symlinks
padrão: "normal"-
Essa sinalização controla como os symlinks de conveniência (os symlinks que aparecem no espaço de trabalho após a compilação) serão gerenciados. Valores possíveis: normal (padrão): cada tipo de symlink de conveniência será criado ou excluído, conforme determinado pela compilação.
clean: Todos os links simbólicos serão excluídos incondicionalmente.
ignore: os links simbólicos não aparecerão.
log_only: gera mensagens de registro como se "normal" tivessem sido passadas, mas não realizam operações de sistema de arquivos (útil para ferramentas).
Apenas os links simbólicos cujos nomes são gerados pelo valor atual de --symlink_prefix podem ser afetados. Se o prefixo for alterado, os links simbólicos preexistentes serão deixados sozinhos.
Tags:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
padrão: "false"-
Essa sinalização controla se vamos ou não postar o evento eventConvenienceSymlinksIdentified no BuildEventProtocol. Se o valor for verdadeiro, o BuildEventProtocol terá uma entrada para conveniênciaSymlinksIdentified, listando todos os links simbólicos criados no espaço de trabalho. Se for falso, a entrada de conveniênciaSymlinksIdentified no BuildEventProtocol ficará vazia.
Tags:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
usos múltiplos foram acumulados-
Obsoleto. Ambiente autônomo.
Tags:affects_outputs
,experimental
--[no]incompatible_use_platforms_repo_for_constraints
padrão: "true"-
O ambiente autônomo foi descontinuado.
Tags:affects_outputs
,incompatible_change
--remote_download_minimal
-
Não faz o download de nenhuma saída de build remota para a máquina local. Essa sinalização é um atalho para as sinalizações: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files e --remote_download_outputs=minimal.
Expande-se para:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
Tags:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
padrão: "todos"- Se definida como "minimal", o download de saídas de compilação remota não será feito na máquina local, exceto as exigidas pelas ações locais. Se definido como "toplevel" se comporta como "minimal", exceto que também faz o download de saídas de destinos de nível superior para a máquina local. Ambas as opções podem reduzir significativamente os tempos de compilação se a largura de banda da rede for um gargalo.
Tags:affects_outputs
--remote_download_symlink_template=<a string>
padrão: ""-
Em vez de fazer o download de saídas de build remotas para a máquina local, crie links simbólicos. O destino dos links simbólicos pode ser especificado na forma de uma string de modelo. Essa string de modelo pode conter {hash} e {size_bytes} que se expandem para o hash do objeto e o tamanho em bytes, respectivamente. 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 de saídas remotas de destinos de nível superior para a máquina local. Essa sinalização é um atalho para sinalizações: --action_cache_store_output_metadata, --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files e --remote_download_outputs=toplevel.
Expande-se como:
--action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tags:affects_outputs
- Padrão
--symlink_prefix=<a string>
: ver descrição -
O prefixo anexado a qualquer um dos symlinks de conveniência criados após uma compilação. Se omitido, o valor padrão é o nome da ferramenta de build seguido de um hífen. Se "/" for passado, nenhum link simbólico será criado e nenhum aviso será emitido. Aviso: a funcionalidade especial para '/' será desativada em breve; em vez dela, use --experimental_convenience_symlinks=ignore.
Tags:affects_outputs
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--[no]experimental_docker_privileged
padrão: "false"-
Se ativado, o Bazel transmitirá a sinalização --privileged para "docker run" ao executar ações. Isso pode ser necessário para sua compilação, mas também pode resultar em menor hermeticidade.
Tags:execution
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--[no]experimental_sandboxfs_map_symlink_targets
padrão: "false"-
Se verdadeiro, mapeia os destinos de links simbólicos especificados como entradas de ação no sandbox. Esse recurso existe apenas para resolver problemas com regras alternativas que não fazem isso sozinhos e precisam ser removidos quando todas as regras forem corrigidas.
Tags:host_machine_resource_optimizations
,execution
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
--[no]incompatible_legacy_local_fallback
padrão: "false"-
Se definido como verdadeiro, ativa o substituto implícito legado do sandbox para a estratégia local. Essa sinalização por padrão será definida como falsa e se tornará um ambiente autônomo. Use --strategy, --spawn_strategy, ou --dynamic_local_strategy para configurar substitutos.
Tags:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
usos múltiplos foram acumulados-
Adicione outro par de caminhos para ativar no sandbox.
Tags:execution
--sandbox_block_path=<a string>
usos múltiplos foram acumulados-
Para ações em sandbox, bloqueie o acesso a esse caminho.
Tags:execution
--[no]sandbox_default_allow_network
padrão: "true"- Permite o acesso à rede por padrão para ações. Isso pode não funcionar com todas as implementações de sandbox.
--[no]sandbox_fake_hostname
padrão: "false"-
Altere o nome do host atual para "localhost" para ações em sandbox.
Tags:execution
--[no]sandbox_fake_username
padrão: "false"-
Altere o nome de usuário atual para "ninguém" em ações do sandbox.
Tags:execution
--sandbox_writable_path=<a string>
usos múltiplos foram acumulados-
Para ações em sandbox, tornar um diretório existente gravável no sandbox (se suportado pela implementação de sandbox, ignorado).
Tags:execution
- Essa opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags do ambiente autônomo
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se compatible_enforce_config_setting_visibility=false, isso é um ambiente autônomo. Caso contrário, se essa sinalização for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa sinalização for verdadeira, config_setting seguirá a mesma lógica de visibilidade que todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplicará as restrições de visibilidade config_setting. Se falso, todos os config_setting ficarão visíveis para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
- 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 se eles estão atualizados. Se todos os resultados dos testes estiverem atualizados, eles serão concluídos com sucesso. Se algum teste precisar ser criado ou executado, um erro será relatado e o teste falhará. Essa opção implica um 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>
usos múltiplos foram acumulados-
Cada teste será repetido até o número especificado de vezes em caso de falha. Os testes que precisam de mais de uma tentativa de aprovação são marcados como "FLAKY" no resumo de testes. Normalmente, o valor especificado é apenas um número inteiro ou a string "padrão". Se for um número inteiro, todos os testes serão executados até N vezes. Se for "default", apenas uma tentativa de teste será feita para os testes regulares, e três para aqueles marcados explicitamente como inconsistentes pela regra (atributo "flaky=1"). Sintaxe alternativa: regex_filter@flaky_test_attempts. Em que flaky_test_attempts é como acima e regex_filter significa uma lista de incluir e excluir padrões de expressão regular (Consulte também --runs_per_test). Exemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desfaz todos os testes em //foo/, exceto os que estão em foo/bar três vezes. Essa opção pode ser passada várias vezes. O argumento passado mais recentemente que corresponde tem precedência. Se nada corresponder, o comportamento será como "padrão" acima.
Tags:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
padrão: "auto"-
O número máximo de jobs de teste locais a serem executados simultaneamente. Toma 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 limitarão o número de jobs de teste local a serem executados simultaneamente. Definir este valor acima do valor para --jobs não é eficaz.
Tags:execution
--[no]test_keep_going
padrão: "true"-
Quando desativado, qualquer teste que não seja aprovado fará com que toda a versão seja interrompida. 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
- Padrão
--test_tmpdir=<a path>
: ver descrição - Especifica o diretório temporário base para o "teste do bazel" usar.
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]announce
padrão: "false"-
Obsoleto. Ambiente autônomo.
Tags:affects_outputs
--[no]debug_spawn_scheduler
padrão: "false"--[no]experimental_bep_target_summary
padrão: "false"- Se os eventos TargetSummary serão publicados.
--[no]experimental_build_event_expand_filesets
padrão: "false"-
Se verdadeiro, expanda Filesets no BEP ao apresentar arquivos de saída.
Tags:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
padrão: "false"-
Se verdadeiro, resolve totalmente os links simbólicos do conjunto de arquivos relativo no BEP ao apresentar arquivos de saída. Requer --experimental_build_event_expand_filesets.
Tags:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
padrão: "4"-
O número máximo de vezes que o Bazel tentará fazer o upload de um evento de versão novamente.
Tags:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
padrão: "1s"-
Atraso inicial inicial para novas tentativas de retirada exponencial quando o upload do BEP falha. (expoente: 1.6)
Tags:bazel_internal_configuration
- Padrão
--experimental_build_event_upload_strategy=<a string>
: ver descrição -
Seleciona como fazer upload de artefatos referenciados no protocolo de eventos de build.
Tags:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
padrão: "true"-
Quando ativadas, as estatísticas de execução (como horário do usuário e do sistema) são registradas para ações executadas localmente que usam sandbox
Tags:execution
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_docker_verbose
padrão: "false"-
Se ativado, o Bazel imprimirá mensagens mais detalhadas sobre a estratégia de sandbox do Docker.
Tags:execution
--[no]experimental_materialize_param_files_directly
padrão: "false"-
Se materializar arquivos de parâmetros, faça isso com gravações diretas no disco.
Tags:execution
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
--experimental_repository_resolved_file=<a string>
padrão: ""-
Se não estiver vazio, grave um valor do Starlark com as informações resolvidas de todas as regras de repositório do Starlark que foram executadas.
Tags:affects_outputs
--[no]experimental_stream_log_file_uploads
padrão: "false"-
Faça o upload dos arquivos de registros por streaming diretamente para o armazenamento remoto, em vez de gravá-los em disco.
Tags:affects_outputs
- Padrão
--explain=<a path>
: ver descrição -
Faz com que o sistema de compilação explique cada etapa executada. A explicação é gravada no arquivo de registros especificado.
Tags:affects_outputs
--[no]legacy_important_outputs
padrão: "true"-
Use-o para suprimir a geração do campo "important_outputs" legado no evento TargetComplete. Essa função é necessária para a integração do Bazel à ResultStore.
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 para depurar ações. Isso está implícito em --subcommands e --verbose_failures.
Tags:execution
--max_config_changes_to_show=<an integer>
padrão: "3"-
Ao descartar o cache de análise devido a uma mudança nas opções de build, são exibidos até o número indicado 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 um resultado de teste excessivamente ruidoso. O cabeçalho de teste está incluído no tamanho do registro. Valores negativos não implicam limite. A saída é tudo ou nada.
Tags:test_runner
,terminal_output
,execution
- Padrão
--output_filter=<a valid Java regular expression>
: ver descrição -
Mostra apenas avisos de regras com um nome correspondente à expressão regular fornecida.
Tags:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
padrão: "0"-
O número de segundos entre os relatórios de 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 depois desse progresso uma vez a cada minuto. Quando --curses está ativado, o progresso é reportado a cada segundo.
Tags:affects_outputs
--remote_print_execution_messages=<failure, success or all>
padrão: "falha"-
Escolha quando imprimir mensagens de execução remota. Os valores válidos são `failure`, para imprimir apenas em falhas, `success` para imprimir apenas em caso de falhas e `all` para imprimir sempre.
Tags:terminal_output
--[no]sandbox_debug
padrão: "false"-
Ativa os recursos de depuração para o recurso de sandbox. Isso inclui duas coisas: primeiro, o conteúdo raiz do sandbox é mantido intacto após uma compilação (e, se o sandboxfs estiver em uso, o sistema de arquivos permanece ativado) e, em seguida, imprime informações extras de depuração na execução. Isso pode ajudar os desenvolvedores de regras do Bazel ou do Starlark com falhas de depuração devido à ausência de arquivos de entrada etc.
Tags:terminal_output
--show_result=<an integer>
padrão: "1"-
Mostra os resultados do build. Para cada destino, indique se ele foi atualizado e, em caso afirmativo, uma lista de arquivos de saída que foram criados. Os arquivos impressos são strings práticas para copiar e colar no shell e executá-los.
Esta opção requer um argumento de número inteiro, que é o número limite de destinos acima do qual as informações de resultado não são impressas. Assim, zero causa a supressão da mensagem e MAX_INT faz com que a impressão do resultado ocorra sempre. O padrão é um.
Se nada foi criado para um destino, os resultados podem ser omitidos para manter a saída abaixo do limite.
Tags:affects_outputs
--[no]subcommands
[-s
] padrão: "false"-
Exibe os subcomandos executados durante uma criação. Sinalizações relacionadas: --execution_log_json_file, --execution_log_binary_file (para o registro de subcomandos em um arquivo em formato compatível com a ferramenta).
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 exibir somente o resumo do status do teste, "errors" para imprimir registros de teste para testes com falha, "all" para imprimir registros de todos os testes e "streamed" para registros de saída para todos os testes em tempo real (isso força os testes a serem executados localmente um de cada vez, independentemente do valor --test_strategy).
Tags:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
padrão: "short"-
Especifica o formato desejado do resumo de teste. Os valores válidos são "curto" para exibir informações somente sobre os testes executados, "terse", para imprimir informações apenas sobre testes malsucedidos que foram executados, "detalhado" para imprimir informações detalhadas sobre casos de teste com falha, "teste" para imprimir o resumo na resolução do caso de teste, "não imprimir" informações detalhadas sobre casos de teste com falha e "nenhum" 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 terá 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>
usos múltiplos foram acumulados-
Especifica os valores dos parâmetros dos aspectos da linha de comando. Cada valor de parâmetro é especificado por meio de <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
--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
--target_pattern_file=<a string>
padrão: ""-
Se definida, a versão lerá padrões do arquivo nomeado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como padrões de linha de comando.
Tags:changes_inputs
- Opções de execução e armazenamento em cache remoto:
- Padrão
--experimental_circuit_breaker_strategy=<failure>
: ver descrição -
Especifica a estratégia a ser usada pelo disjuntor. As estratégias disponíveis são "falha". Em um valor inválido para a opção, o comportamento da opção não é definido.
Tags:execution
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--[no]experimental_guard_against_concurrent_changes
padrão: "false"- Desative essa opção para desativar a verificação do tamanho dos arquivos de entrada de uma ação antes de fazer upload dela para um cache remoto. Pode haver casos em que o kernel do Linux atrasa a gravação de arquivos, o que pode causar falsos positivos.
--[no]experimental_remote_cache_async
padrão: "false"- Se for verdadeiro, a E/S do cache remoto ocorrerá em segundo plano em vez de ocorrer como parte de uma geração.
--experimental_remote_cache_eviction_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de repetição se o build encontrar um erro de remoção de cache remoto. Um valor diferente de zero será definido implicitamente --compatible_remote_use_new_exit_code_for_lost_inputs como verdadeiro.
Tags:execution
--experimental_remote_cache_ttl=<An immutable length of time.>
padrão: "3h"-
O TTL mínimo garantido de blobs no cache remoto depois que os resumos são referenciados recentemente, por exemplo, por um ActionResult ou um FindMissingBlobs. O Bazel faz várias otimizações com base no TTL dos blobs. Por exemplo, ele não chama GetActionResult repetidamente em uma compilação incremental. O valor precisa ser um pouco menor do que o TTL real, já que há uma lacuna entre o momento em que o servidor retorna os resumos e o momento em que o Bazel os recebe.
Tags:execution
- Padrão
--experimental_remote_capture_corrupted_outputs=<a path>
: ver 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: "false"- Se esta política for definida como verdadeira, descarte cópias na memória da árvore de Merkle da raiz de entrada e mapeamentos de entrada associados durante chamadas para GetActionResult() e Execute(). Isso reduz significativamente o uso de memória, mas exige que o Bazel faça um novo cálculo em ausências e tentativas de cache remota.
- Padrão
--experimental_remote_downloader=<a string>
: ver descrição - Um URI de endpoint da API Remote Asset, para ser usado como um proxy de download remoto. Os esquemas compatíveis são grpc, grpcs (grpc com TLS ativado) e unix (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. 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 a ferramenta de download remota falha quando é usada novamente.
--[no]experimental_remote_execution_keepalive
padrão: "false"- O uso de sinal de atividade para chamadas de execução remota.
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
padrão: "10"-
Define o número permitido de taxa de falhas em porcentagem para uma janela de tempo específica. Depois disso, ele interrompe a chamada ao cache/executor remoto. Por padrão, o valor é 10. Definir como 0 significa que não há limitação.
Tags:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
padrão: "60 s"-
O intervalo em que a taxa de falha das solicitações remotas é calculada. Em valor zero ou negativo, a duração da falha é calculada em toda a duração da execução.As unidades a seguir podem ser usadas: dias (d), horas (h), minutos (m), segundos (s) e milissegundos (ms). Se a unidade for omitida, o valor será interpretado como segundos.
Tags:execution
--[no]experimental_remote_mark_tool_inputs
padrão: "false"- Se definido como verdadeiro, o Bazel marcará as entradas como entradas de ferramenta para o executor remoto. Isso pode ser usado para implementar workers permanentes remotos.
--[no]experimental_remote_merkle_tree_cache
padrão: "false"- Se definida como verdadeira, os cálculos da árvore do Merkle serão memorizados para melhorar a velocidade de verificação de ocorrência em cache remoto. A impressão na memória do cache é controlada por --experimental_remote_merkle_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer>
padrão: "1000"- O número de árvores do Merkle a serem memorizadas para melhorar a velocidade de verificação de ocorrência em cache remoto. Mesmo que o cache seja automaticamente removido de acordo com o tratamento de referências leves do Java, erros de falta de memória podem ocorrer se a configuração for muito alta. Se definido como 0, o tamanho do cache é ilimitado. O valor ideal varia de acordo com o tamanho do projeto. O padrão é 1.000.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
--[no]incompatible_remote_build_event_upload_respect_no_cache
padrão: "false"- Obsoleto. Ambiente autônomo. Use --remote_build_event_upload=minimal.
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
padrão: "true"-
Se definido como verdadeiro, uma ação executada remotamente não poderá produzir um artefato de árvore contendo um link simbólico relativo. Os links simbólicos absolutos nunca são permitidos, independentemente dessa sinalização.
Tags:execution
,incompatible_change
--[no]incompatible_remote_downloader_send_all_headers
padrão: "true"-
Se todos os valores de um cabeçalho com vários valores serão enviados para o download remoto em vez de apenas o primeiro.
Tags:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
padrão: "false"-
Se definido como verdadeiro, os caminhos de saída serão relativos à raiz de entrada em vez do diretório de trabalho.
Tags:incompatible_change
--[no]incompatible_remote_results_ignore_disk
padrão: "true"-
Se definido como verdadeiro, --noremote_upload_local_results e --noremote_accept_cached não se aplicarão ao cache de disco. Se --disk_cache e --remote_cache estiverem definidos (combinados):
--noremote_upload_local_results fará com que os resultados sejam gravados no cache de disco, mas não enviados ao cache remoto.
--noremote_accept_cached faz com que o Bazel verifique os resultados no cache do disco, mas não no cache remoto.
ações no-remote-exec podem atingir o cache de disco.
Consulte #8216 para obter detalhes.
Tags:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
padrão: "true"-
Se definido como verdadeiro, o Bazel usará o novo código de saída 39 em vez de 34, se o cache remoto remover blobs durante a versão.
Tags:incompatible_change
--[no]remote_accept_cached
padrão: "true"- Se os resultados da ação serão armazenados em cache remotamente.
--remote_build_event_upload=<all or minimal>
padrão: "mínima"- Se definido como "todos", todas as saídas locais referenciadas pelo BEP são enviadas para o cache remoto. Se definido como "mínimo", as saídas locais referenciadas pelo BEP não são enviadas para o cache remoto, exceto para arquivos que são importantes para os consumidores do BEP (por exemplo, registros de teste e perfil de tempo). O esquema bytestream:// é sempre usado para o URI de arquivos mesmo se não estiverem armazenados no cache remoto. O padrão é "minimal".
- Padrão
--remote_bytestream_uri_prefix=<a string>
: ver descrição - O nome do host e o nome da instância a serem usados nos URIs bytestream:// que são gravados nos fluxos de eventos de versão. Essa opção pode ser definida quando versões são executadas 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}".
- Padrão
--remote_cache=<a string>
: ver descrição - Um URI de um endpoint de armazenamento em cache. Os esquemas compatíveis são http, https, grpc, grpcs (grpc com TLS ativado) e unix (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. Especifique o esquema grpc://, http:// ou unix: para desativar o TLS. Consulte https://bazel.build/remote/caching.
--[no]remote_cache_compression
padrão: "false"- Se ativada, compacte/descompacte os blobs de cache com o zstd.
--remote_cache_header=<a 'name=value' assignment>
usos múltiplos foram 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 sinalização 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>
usos múltiplos foram acumulados-
Defina as propriedades exec padrão para serem usadas como a plataforma de execução remota se uma plataforma de execução ainda não tiver definido exec_properties.
Tags:affects_outputs
--remote_default_platform_properties=<a string>
padrão: ""- Defina as propriedades da plataforma padrão que serão definidas para a API de execução remota, se a plataforma de execução ainda não tiver definido remote_execution_properties. Esse valor também será usado se a plataforma do host for selecionada como a plataforma de execução remota.
--remote_downloader_header=<a 'name=value' assignment>
usos múltiplos foram acumulados- Especifique um cabeçalho que será incluído nas solicitações de download remoto: --remote_downloader_header=Name=Value. É possível transmitir vários cabeçalhos especificando a sinalização 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>
usos múltiplos foram 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 sinalização 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.
- Padrão
--remote_executor=<a string>
: ver 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 (soquetes UNIX locais). Se nenhum esquema for fornecido, o Bazel assumirá como padrão o grpcs. Especifique o esquema grpc:// ou unix: para desativar o TLS.
- Padrão
--remote_grpc_log=<a path>
: ver descrição - Se especificada, um caminho para um arquivo para registrar detalhes relacionados à chamada gRPC. Esse registro consiste em uma sequência de protobufs com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry serializados com cada mensagem prefixada por um varint que indica o tamanho da seguinte mensagem protobuf serializada, conforme realizada pelo método LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
usos múltiplos foram 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 sinalização 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 a estratégia de execução local independente retorna à execução em caso de falha.
--remote_local_fallback_strategy=<a string>
padrão: "local"- Ambiente autônomo, obsoleto. Veja mais detalhes em https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
padrão: "100"-
Limite o número máximo de conexões simultâneas ao 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 lidar com uma solicitação por vez, então o Bazel pode fazer até --remote_max_connections solicitações simultâneas.
Para cache/executor remoto do gRPC, um canal gRPC geralmente aceita mais de 100 solicitações simultâneas. Assim, o Bazel faz cerca de solicitações "--remote_max_connections * 100".
Tags:host_machine_resource_optimizations
- Padrão
--remote_proxy=<a string>
: ver descrição - Conecte-se ao cache remoto por meio de um proxy. Essa sinalização 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 de ações remotas a serem armazenadas no cache remoto. A semântica dos valores de prioridade específicos depende do servidor.
--remote_retries=<an integer>
padrão: "5"- O número máximo de tentativas de repetir um erro temporário. Se definido como 0, as tentativas serão desativadas.
--remote_retry_max_delay=<An immutable length of time.>
padrão: "5s"- O atraso máximo de espera entre as tentativas de repetição remota. 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.
--remote_timeout=<An immutable length of time.>
padrão: "60 s"- O tempo máximo de espera para execução remota e chamadas de cache. Para o cache REST, são usados 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 é necessário fazer upload dos resultados de ação executados localmente no cache remoto se o cache remoto for compatível e o usuário estiver autorizado a fazer isso.
--[no]remote_verify_downloads
padrão: "true"- Se definido como verdadeiro, o Bazel 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:
--auto_output_filter=<none, all, packages or subpackages>
padrão: "nenhum"- 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" (nenhum / filtrar tudo), "all" (filtrar tudo / mostrar nada), "packages" (incluir a saída de regras nos pacotes mencionados na linha de comando do Blaze) e "subpackages" (como "packages", mas também incluir 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 os destinos de teste marcados como "manual" a serem criados. Testes "manuais" são excluídos do processamento. Essa opção os força a serem criados (mas não executados).
--build_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista de tags separada por vírgulas. Cada tag pode ser precedida por "-" para especificar as tags excluídas. Somente esses destinos serão criados contendo pelo menos uma tag incluída e não contendo nenhuma tag excluída. 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 especificada, apenas 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: "nenhum"- Especifica o tipo de relatório de cobertura cumulativa desejado. No momento, somente LCOV é suportado.
--[no]compile_one_dependency
padrão: "false"- Compile uma única dependência dos arquivos de argumentos. Isso é útil para verificar a sintaxe dos arquivos de origem em ambientes de desenvolvimento integrado, 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/criação/teste. Este argumento afeta a forma como todos os argumentos sem sinalização são interpretados. Em vez de serem destinos para compilação, eles são nomes de arquivos de origem. Para cada nome de arquivo de origem, será criado um destino arbitrário que depende dele.
--deleted_packages=<comma-separated list of package names>
usos múltiplos foram acumulados- Uma lista separada por vírgulas de nomes de pacotes que o sistema de compilação considerará inexistente, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use esta opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, após excluir x/y/BUILD de seu cliente, o sistema de compilação pode 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 aproximadamente 10%, mas torna as compilações incrementais mais lentas.
- Padrão
--disk_cache=<a path>
: ver descrição - Um caminho para um diretório em que o Bazel lê e grava ações e saídas. 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 versão em binário
- Padrão
--execution_log_binary_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como protos delimitados de spawn, de acordo com src/main/protobuf/spawn.proto. Primeiro, o registro é gravado de forma não ordenada e, em seguida, no final da invocação, é classificado em uma ordem estável (pode consumir muita CPU e memória). Sinalizadores relacionados: --execution_log_json_file (formato de texto json ordenado), --experimental_execution_log_file (formato protobuf binário não ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
- Padrão
--execution_log_json_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como representação json dos protos delimitados por spawn, de acordo com src/main/protobuf/spawn.proto. Primeiro, o registro é gravado de forma não ordenada e, em seguida, no final da invocação, é classificado em uma ordem estável (pode consumir muita CPU e memória). Sinalizações relacionadas: Sinalizações relacionadas: --execution_log_binary_file (formato protobuf binário ordenado), --experimental_execution_log_file (formato protobuf binário não ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
--[no]execution_log_sort
padrão: "true"- Se é para classificar o registro de execução. Defina como "false" para melhorar o desempenho da memória, mas tenha o custo de produzir o registro em uma ordem não determinística.
--[no]expand_test_suites
padrão: "true"-
Expanda os destinos "test_suite" nos testes constituintes deles antes da análise. Quando essa sinalização estiver ativada (o padrão), os padrões de destino negativos serão aplicados aos testes pertencentes ao conjunto de testes. Caso contrário, não serão. A desativação dessa sinalização é útil quando os aspectos de nível superior são aplicados na linha de comando e podem analisar os destinos test_suite.
Tags:loading_and_analysis
- Padrão
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: ver descrição -
Recebe uma lista de números de sinais do SO. Se uma ramificação local de execução dinâmica for eliminada com algum desses sinais, ela poderá ser concluída. Para workers persistentes, isso afeta apenas os sinais que interrompem o processo do worker.
Tags:execution
- Padrão
--experimental_execution_log_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como protos delimitados de spawn, de acordo com src/main/protobuf/spawn.proto. Esse arquivo é gravado na ordem da execução dos spawns. Sinalizações relacionadas: --execution_log_binary_file (formato protobuf binário ordenado), --execution_log_json_file (formato json de texto ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
--[no]experimental_execution_log_spawn_metrics
padrão: "false"- Inclua métricas de spawn no registro de spawn executado.
--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 segmentações para programar extra_actions.
--[no]experimental_extra_action_top_level_only
padrão: "false"- Obsoleto, substituído por aspectos. Programa apenas extras_actions para segmentações de nível superior.
--[no]experimental_prioritize_local_actions
padrão: "true"-
Se definidas, as ações que podem ser executadas apenas localmente têm primeira chance de adquirir recursos, os workers de execução dinâmica têm uma segunda chance e as ações independentes executadas dinamicamente ficam por último.
Tags:execution
--experimental_spawn_scheduler
-
Permita a execução dinâmica executando ações local e remotamente em paralelo. O Bazel gera cada ação localmente 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 permanente. Para ativar a execução dinâmica de um mnemônico de ação individual, use as sinalizações `--internal_spawn_scheduler` e `--strategy=<mnemonic>=dynamic`.
Expande-se como:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]experimental_worker_sandbox_hardening
padrão: "false"-
Se ativada, os workers são executados em um sandbox reforçado, se a implementação permitir.
Tags:execution
--[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.
--[no]incompatible_dont_use_javasourceinfoprovider
padrão: "false"-
Tags do ambiente autônomo
:incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
padrão: "HOST_CPUS"- Defina explicitamente o número total de núcleos de CPU local disponíveis para o Bazel gastar em ações de compilação executadas localmente. Usa um número inteiro, ou "HOST_CPUS", opcionalmente seguido de [-|*]<float> (por exemplo, HOST_CPUS*.5 para usar metade dos núcleos de CPU disponíveis).Por padrão, ("HOST_CPUS"), o Bazel consultará a configuração do sistema para estimar o número de núcleos de CPU disponíveis.
--local_extra_resources=<a named float, 'name=value'>
usos múltiplos foram acumulados- Defina o número de recursos extras disponíveis para o Bazel. Recebe um par de flutuação de string. Pode ser usado várias vezes para especificar vários tipos de recursos extras. O Bazel limitará as ações em execução simultânea com base nos recursos extras disponíveis e nos recursos adicionais necessários. Os testes podem declarar a quantidade de recursos extras necessários usando uma tag no formato "resources:<resoucename>:<amount>" CPU, RAM e recursos disponíveis não podem ser definidos com esta sinalização.
--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 compilação executadas localmente. Toma 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 consultará a configuração do sistema para estimar a quantidade de RAM disponível e usará 67% dela.
--local_termination_grace_seconds=<an integer>
padrão: "15"- Tempo de espera entre o encerramento de um processo local devido ao tempo limite e encerramento forçado.
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--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 incluído. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
--test_lang_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista separada por vírgulas dos idiomas de teste. Cada idioma pode ser precedido por "-" para especificar os idiomas excluídos. Apenas os destinos de teste que estiverem escritos nos idiomas especificados serão encontrados. O nome usado para cada idioma deve ser o mesmo que o prefixo do idioma na regra *_test, por exemplo, "cc", "java", "py" etc. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
padrão: ""- Especifica uma lista separada por vírgulas de tamanhos de teste. Cada tamanho pode ser precedido por "-" para especificar os tamanhos excluídos. Apenas os destinos de teste que contiverem pelo menos um tamanho incluído e não contiverem tamanhos excluídos. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--test_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista de tags de teste separadas por vírgulas. Cada tag pode ser precedida por "-" para especificar as tags excluídas. Somente os destinos de teste que contiverem pelo menos uma tag incluída e não contiverem tags excluídas serão encontrados. Essa opção afeta o comportamento --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 de tempos limite de teste separados por vírgulas. Cada tempo limite pode ser precedido por "-" para especificar os tempos limite excluídos. Apenas os destinos de teste que contiverem pelo menos um tempo limite incluído e nenhum tempo limite excluído serão exibidos. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--workspace_status_command=<path>
padrão: ""- Um comando invocado no início da versão 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 obter 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:
--[no]check_up_to_date
padrão: "false"-
Não execute o build. Apenas verifique se ele está atualizado. Se todos os destinos estiverem atualizados, a versão será concluída. Se alguma etapa precisar ser executada, um erro será relatado e a compilação falhará.
Tags:execution
--[no]experimental_inprocess_symlink_creation
padrão: "false"-
Se é para fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Se as ações do manifesto de origem precisam ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel executará o pós-processamento de cobertura para teste em um novo spawn.
Tags:execution
--[no]experimental_split_xml_generation
padrão: "true"-
Se essa sinalização for 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 que contém o registro de teste. Caso contrário, o Bazel gerará um test.xml como parte da ação de teste.
Tags:execution
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos tratarão todos os artefatos de saída como arquivos comuns. Eles não cruzam diretórios nem são sensíveis a links simbólicos.
Tags:execution
--[no]experimental_use_semaphore_for_jobs
padrão: "false"-
Se definido como verdadeiro, use também o semaphore para limitar o número de jobs simultâneos.
Tags:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
padrão: ""-
Especifique como executar regras gerais. Esta sinalização será descontinuada. Use --spawn_strategy=<value> para controlar todas as ações ou --strategy=Genrule=<value> para controlar apenas regras gerais.
Tags:execution
--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. Toma 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 que falhou e os 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 para a fase de carregamento/análise.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" define um padrão razoável com base nos recursos do host. Precisa ser pelo menos 1.
Tags:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
padrão: ""-
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico da ação. Aplica-se apenas a ações compatíveis com informações de execução. Muitas ações comuns aceitam informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Ao especificar vários valores, a ordem é importante porque muitas regex podem se aplicar ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
".*=+x,.*=-y,.*=+z" adiciona "x" e "z" às informações de execução de todas as ações e remove "y".
"Genrule=+requires-x" adiciona "requires-x" às informações de execução para todas as ações da regra de regra.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são da Generule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Permita ações de dex e desugar permanentes do Android usando workers.
Expande-se para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ativa o processador de recursos permanente do Android usando workers.
Expande-se para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
{14/
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Permite ações dex e multiplex persistentes do Android usando workers.
Expande-se para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ativa o processador de recursos multiplexados persistentes do Android usando workers.
Expande-se 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
{14/
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Ativa ferramentas Android persistentes e multiplexadas (dexação, simplificação e processamento de recursos).
Expande-se para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
padrão: "false"-
Ignore destinos incompatíveis que estejam explicitamente listados na linha de comando. Por padrão, criar esses destinos resulta em um erro, mas eles são ignorados quando essa opção está ativada. Consulte: https://bazel.build/extending/platforms#skipping-compatible-targets
Tags:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
padrão: ""-
Especifique como as ações de geração são executadas por padrão. Aceita uma lista de estratégias separadas por vírgulas, da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a prioridade mais alta que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Veja mais detalhes em https://blog.bazel.build/2019/06/19/list-strategy.html.
Tags:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
usos múltiplos foram acumulados-
Especifique como distribuir a compilação de outras ações de spawn. Aceita uma lista de estratégias separadas por vírgulas, da prioridade mais alta para a mais baixa. Para cada ação, o Bazel escolhe a estratégia com a prioridade mais alta que pode executar a ação. O valor padrão é "remote,worker,sandboxed,local". Essa sinalização modifica os valores definidos por --spawn_strategy (e --genrule_strategy se usados com mnemônico Genrule). Veja mais detalhes em https://blog.bazel.build/2019/06/19/list-strategy.html.
Tags:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
usos múltiplos foram acumulados-
Substitui qual estratégia de geração é usada para executar ações de spawning com descrições correspondentes a um determinado regex_filter. Consulte --per_file_copt para obter detalhes sobre a correspondência de regex_filter. O último regex_filter que corresponde à descrição é usado. Essa opção substitui outras sinalizações 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 executará "Compilação //foo/bar/baz" com a estratégia "local", mas reverter a ordem a executaria com "sandboxed".
Tags:execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel usará a plataforma de destino para executar testes em vez do grupo executivo de teste.
Tags:execution
- Opções que configuram o conjunto de ferramentas usado para a execução da ação:
- Padrão
--android_compiler=<a string>
: ver descrição -
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
padrão: "//external:android/crosstool"-
O local do compilador C++ usado para builds do Android.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--android_grte_top=<a label>
: ver descrição -
O destino Android grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para as regras android_binary. Sinalização para ajudar na transição do manifesto legado para a combinação do manifesto do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK multiarquitetura, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
padrão: "@bazel_tools//tools/android:sdk"-
Especifica o SDK/a plataforma Android usados para criar apps Android.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--apple_compiler=<a string>
: ver descrição -
O compilador de destino da Apple. Útil para selecionar variantes de um conjunto de ferramentas (por exemplo, xcode-beta).
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote crosstool a ser usado nas regras da Apple e Objc e as dependências delas.
Tags:loses_incremental_state
,changes_inputs
- Padrão
--apple_grte_top=<a build target label>
: ver descrição -
A segmentação da Apple grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
,explicit_in_output_path
- Padrão
--compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar os relatórios de cobertura brutos. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote entre ferramentas a ser usado para compilar o código C++.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--custom_malloc=<a build target label>
: ver descrição -
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de compilação.
Tags:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiplos foram acumulados-
Lista de expressões regulares separadas por vírgula, cada uma opcionalmente prefixada por - (expressão negativa), atribuída (=) a uma lista de segmentações de valores de restrição separados por vírgulas. Se um destino não corresponder a nenhuma expressão negativa e pelo menos uma expressão positiva, a resolução do conjunto de ferramentas será executada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 adicionará "x86_64" a qualquer destino em //demo, exceto para aqueles cujo nome contenha "test".
Tags:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
padrão: "true"-
Permite que as regras de objc_* dependam da cc_library e que qualquer dependência do objc seja criada com --cpu definido como "ios_<--ios_cpu>" para quaisquer valores em --ios_multi_cpu.
Tags:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definida, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão 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
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Caso verdadeiro, use o Xcode mais recente, disponível localmente e remotamente. Se for falso ou se não houver versões mútuas disponíveis, use a versão local do Xcode, selecionada via xcode-select.
Tags:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas disponíveis para execução de ações. As plataformas podem ser especificadas pelo destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores substituirão as configurações de sinalização anteriores.
Tags:execution
--extra_toolchains=<comma-separated list of options>
usos múltiplos foram acumulados-
As regras do conjunto de ferramentas a serem consideradas durante a resolução do conjunto de ferramentas. Os conjuntos de ferramentas podem ser especificados por destino exato ou como 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
- Padrão
--grte_top=<a label>
: ver descrição -
Um rótulo para uma biblioteca libc de entrada. O valor padrão é selecionado pelo conjunto de ferramentas de várias ferramentas, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para a compilação do host. Ela será ignorada se --host_crosstool_top não estiver definido.
Tags:loading_and_analysis
,execution
- Padrão
--host_crosstool_top=<a build target label>
: ver descrição -
Por padrão, as opções --crosstool_top e --compiler também são usadas na configuração exec. Se essa sinalização for fornecida, o Bazel usará a libc e o compilador padrão para o crosstool_top fornecido.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--host_grte_top=<a label>
: ver descrição -
Se especificada, esta configuração substitui o diretório de nível superior libc (--grte_top) para a configuração exec.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@local_config_platform//:host"-
O rótulo de uma regra de plataforma que descreve o sistema host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
padrão: "true"-
Se verdadeiro, o Bazel não permitirá especificar expand_if_all_available em flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não ativará os recursos "host" e "nonhost" no conjunto 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_android_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK do Android para regras do Android (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
padrão: "true"-
Se verdadeiro, o Bazel não reutilizará linhas de comando de ação de link C++ para linhas de comando de indexação lto. Consulte https://github.com/bazelbuild/bazel/issues/6791 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_linking_info_migration
padrão: "true"-
Se verdadeiro, as regras integradas do ObjC vão receber as informações de vinculação do CcInfo em vez do ObjcProvider. Veja mais detalhes e informações sobre a migração em https://github.com/bazelbuild/bazel/issues/16939
Tags:loading_and_analysis
,changes_inputs
eincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
padrão: "true"-
Se verdadeiro, o Bazel reclamará quando os atributos cc_toolchain.cpu e cc_toolchain.compiler forem definidos (consulte as instruções de migração em https://github.com/bazelbuild/bazel/issues/7075).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vinculará dependências de biblioteca como arquivo inteiro por padrão. Consulte https://github.com/bazelbuild/bazel/issues/7362 para ver instruções de migração.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
padrão: "true"-
Se verdadeiro, o Bazel exigirá o parâmetro "ctx" em cc_common.configure_features. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/7793.
Tags:loading_and_analysis
,incompatible_change
-
Use objetos compartilhados na interface se compatível com o conjunto de ferramentas. No momento, todos os conjuntos de ferramentas ELF são compatíveis com essa configuração.
Tags:loading_and_analysis
,affects_outputs
eaffects_outputs
- Padrão
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do iOS que será usada para criar aplicativos para iOS. Se não for especificado, usará a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do macOS que será usada para criar aplicativos para macOS. Se não for especificado, usará a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--minimum_os_version=<a string>
: ver descrição -
A versão mínima do sistema operacional que sua compilação segmenta.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais sinalizações definir quando já houver uma plataforma. Precisa ser relativo à raiz principal do espaço de trabalho. O padrão é "platform_mappings" (um arquivo diretamente abaixo da raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras de plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
- Padrão
--python2_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python3_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python_path=<a string>
: ver descrição -
O caminho absoluto do interpretador do Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--python_top=<a build target label>
: ver descrição -
O rótulo de um py_runtime que representa o interpretador de Python invocado para executar destinos em Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos tvOS. Se não for especificado, usará a versão padrão do SDK tvOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do watchOS que vai ser usada para criar apps watchOS. Se não for especificado, usará a versão padrão do SDK watchOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--xcode_version=<a string>
: ver descrição -
Se especificada, usa o Xcode da versão fornecida para ações de build relevantes. Se não for especificado, usará a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_enable_auto_dsym_dbg
padrão: "false"-
Se há força para ativar a geração de arquivos de símbolo de depuração (.dSYM) para builds do dbg.
Tags:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
padrão: "false"-
Se os arquivos de símbolos de depuração (.dSYM) serão gerados ou não.
Tags:affects_outputs
,action_command_lines
--[no]build
padrão: "true"-
Execute o build. Esse é o comportamento normal. Especificar --nobuild faz com que a compilação pare antes de executar as ações dela, retornando zero se as fases de carregamento e análise do pacote tiverem sido concluídas com êxito. Este modo é útil para testar essas fases.
Tags:execution
,affects_outputs
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria runfiles symlink Forests para todos os destinos. Se for falso, escreva apenas manifestos quando possível.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de arquivos de execução para todos os destinos. Se falso, omiti-los. A execução dos testes locais falhará se ela for falsa.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao compilar testes de C++ estaticamente e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os prefixos dos arquivos principais criados por cc_proto_library.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os prefixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute mais ações para versões alternativas da API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
padrão: "false"-
Execute mais ações para versões alternativas da API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
padrão: "true"-
Use --run_validations.
Tags:execution
,affects_outputs
--[no]experimental_save_feature_state
padrão: "false"-
Salvar o estado de recursos ativados e solicitados como uma saída de compilação.
Tags:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
padrão: "false"-
Executar ações de validação usando aspecto (para paralelismo com testes).
Tags:execution
,affects_outputs
--fission=<a set of compilation modes>
padrão: "não"-
Especifica quais modos de compilação usam a fissão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos arquivos de execução, o que corresponde ao comportamento recomendado para regras Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "true"-
Se for verdadeiro, crie florestas de links simbólicos para arquivos externos em repositórios .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se é necessário gerar um arquivo de linkmap.
Tags:affects_outputs
--output_groups=<comma-separated list of options>
usos múltiplos foram acumulados-
Uma lista de nomes de grupos de saída separados por vírgulas, cada um opcionalmente prefixado com 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 for prefixado, o conjunto padrão de grupos de saída será omitido. Por exemplo, --output_groups=+foo,+bar constrói a união do conjunto padrão, foo e bar, enquanto --output_groups=foo,bar modifica o conjunto padrão de forma que apenas foo e bar sejam criados.
Tags:execution
,affects_outputs
--[no]run_validations
padrão: "true"-
Se é para executar ações de validação como parte do build. Consulte https://bazel.build/extending/rules#validation_actions
Tags:execution
,affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), arquivos .i (C pré-processado) e arquivos .ii (C++ pré-processado).
Tags:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiplos foram acumulados-
Especifica o conjunto de variáveis de ambiente disponíveis para ações com a configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serão acumuladas.
Tags:action_command_lines
--android_cpu=<a string>
padrão: "armeabi-v7a"-
A CPU de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
padrão: "false"-
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso é usado apenas com a vinculação de dados v2.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "false"-
Use a vinculação de dados do Android v2 com o argumento 3.4.0
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"- Determina se dependências de C++ de regras do Android serão vinculadas dinamicamente quando um cc_binary não cria explicitamente uma biblioteca compartilhada. "padrão" significa que o Bazel escolherá a vinculação de forma dinâmica. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alfabético"-
Define a ordem dos manifestos transmitidos à combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação à 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 anterior aos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--aspects=<comma-separated list of options>
usos múltiplos foram acumulados- Lista separada por vírgulas de aspectos a serem aplicados a metas de nível superior. Na lista, se some_aspect especificar os provedores de aspecto necessários por meio dos required_aspect_providers, alguns_aspect serão executados depois de cada aspecto mencionado antes na lista, cujos provedores anunciados atendem a alguns_provedores de aspecto obrigatórios. Além disso, some_aspect será executado depois de todos os aspectos obrigatórios especificados por exigir atributo. 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
--[no]build_python_zip
padrão: "auto"-
Crie o zip executável do Python. No Windows, desative em outras plataformas.
Tags:affects_outputs
--catalyst_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas 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 instrumentará o código (usando instrumentação off-line sempre que possível) e coletará informações de cobertura durante os testes. Apenas as segmentações que correspondem a --instrumentation_filter serão afetadas. Normalmente, essa opção não deve ser especificada diretamente. O comando "bazel cover" deve ser usado.
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
,explicit_in_output_path
--conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir para o GCC ao compilar arquivos de origem em C.
Tags:action_command_lines
,affects_outputs
--copt=<a string>
usos múltiplos foram acumulados-
Outras opções para passar para o GCC.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
,explicit_in_output_path
- Padrão
--cs_fdo_absolute_path=<a string>
: ver descrição -
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil bruto ou indexado do LLVM.
Tags:affects_outputs
- Padrão
--cs_fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação de 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 descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--cs_fdo_profile=<a build target label>
: ver descrição -
O cs_fdo_profile que representa o perfil sensível de contexto a ser usado para otimização.
Tags:affects_outputs
--cxxopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transferir para gcc ao compilar arquivos de origem em C++.
Tags:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
usos múltiplos foram acumulados-
Cada opção --define especifica uma atribuição para uma variável de versão.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados dinamicamente. "padrão" significa que o Bazel vinculará dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
padrão: "true"-
Se definido, o uso de fdo_absolute_profile_path gerará um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ativa a árvore de links simbólicos dos arquivos de execução. Por padrão, ela fica desativada no Windows e em outras plataformas.
Tags:affects_outputs
--experimental_action_listener=<a build target label>
usos múltiplos foram acumulados-
Obsoleto, substituído por aspectos. Use action_listener para anexar uma extra_action a ações de versão existentes.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compacte recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "false"-
Use a vinculação de dados do Android v2
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
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
usar a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_convenience_symlinks
padrão: "normal"-
Essa sinalização controla como os symlinks de conveniência (os symlinks que aparecem no espaço de trabalho após a compilação) serão gerenciados. Valores possíveis: normal (padrão): cada tipo de symlink de conveniência será criado ou excluído, conforme determinado pela compilação.
clean: Todos os links simbólicos serão excluídos incondicionalmente.
ignore: os links simbólicos não aparecerão.
log_only: gera mensagens de registro como se "normal" tivessem sido passadas, mas não realizam operações de sistema de arquivos (útil para ferramentas).
Apenas os links simbólicos cujos nomes são gerados pelo valor atual de --symlink_prefix podem ser afetados. Se o prefixo for alterado, os links simbólicos preexistentes serão deixados sozinhos.
Tags:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
padrão: "false"-
Essa sinalização controla se vamos ou não postar o evento eventConvenienceSymlinksIdentified no BuildEventProtocol. Se o valor for verdadeiro, o BuildEventProtocol terá uma entrada para conveniênciaSymlinksIdentified, listando todos os links simbólicos criados no espaço de trabalho. Se for falso, a entrada de conveniênciaSymlinksIdentified no BuildEventProtocol ficará vazia.
Tags:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
usos múltiplos foram acumulados-
Obsoleto. Ambiente autônomo.
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 verdadeiro, use libunwind para liberar a pilha e compile com tabelas -fomit-frame-pointer e -fasynchronous-unwind.
Tags:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, a plataforma de destino é usada no nome do diretório de saída em vez da CPU.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificada, o Bazel gera informações do mapa de cobertura llvm-cov em vez de gcov quando a função collection_code_coverage está ativada.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated set of options>
padrão: "armeabi-v7a"-
Definir essa opção ativa APKs multiarquitetura, que contêm binários nativos para todas as arquiteturas de destino especificadas, por exemplo, --fat_apk_cpu=x86,armeabi-v7a. Se essa sinalização for especificada, --android_cpu será ignorado para dependências de regras android_binary.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
padrão: "false"-
Se quer criar divisões HWASAN.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--fdo_optimize=<a string>
: ver descrição -
Use as informações do perfil do FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP contendo uma árvore de arquivos .gcda, um arquivo afdo que contenha um perfil automático ou um arquivo de perfil LLVM. Essa sinalização também aceita arquivos especificados como marcadores (por exemplo, `//foo/bar:file.afdo` - pode ser necessário adicionar uma diretiva `exports_files` ao pacote correspondente) e marcadores apontando para destinos `fdo_profile`. Essa sinalização será substituída pela regra "fdo_profile".
Tags:affects_outputs
- Padrão
--fdo_prefetch_hints=<a build target label>
: ver descrição -
Use as dicas de pré-busca de cache.
Tags:affects_outputs
- Padrão
--fdo_profile=<a build target label>
: ver descrição -
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
--features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão nos destinos criados na configuração deles. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Veja também --host_features
Tags:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ produzem código independente de posição ("-fPIC"), os links preferem bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e links 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>
usos múltiplos foram 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á obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serã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 integradas. Valores: 'fastbuild', 'dbg', 'opt'.
Tags:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir ao compilador C ao compilar arquivos de origem em C, mas não em C++, nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_copt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C as ferramentas criadas nas configurações exec.
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>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C++ as ferramentas criadas nas configurações exec.
Tags:action_command_lines
,affects_outputs
--host_features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão para os destinos criados na configuração exec. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
- Padrão
--host_force_python=<PY2 or PY3>
: ver 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>
usos múltiplos foram acumulados-
Outra opção para transmitir ao vinculador ao vincular ferramentas nas configurações exec.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações do executivo. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da linha de comando -O0 à linha de comando gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir um arquivo swiftc a ferramentas exec.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo executivo é criado automaticamente para cada conjunto de ferramentas usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro `toolchain` em suas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_avoid_conflict_dlls
padrão: "true"-
Se ativado, todas as bibliotecas dinâmicas dinâmicas C++ (DLLs, na sigla em inglês) geradas por cc_library no Windows serão renomeadas como name_{hash}.dll, em que o hash é calculado com base no nome do repositório e no caminho do pacote da DLL. Essa opção é útil quando você tem um pacote que depende de vários cc_library com o mesmo nome (por exemplo, //foo/bar1:utils e //foo/bar2:utils).
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório "genfiles" será dobrado no diretório "bin".
Tags:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
padrão: "false"-
Se for verdadeiro, use --features apenas para a configuração de destino e --host_features para a configuração exec.
Tags:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação das regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. Caso contrário, as regras de teste sempre serão 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 estiver ativada, somente as regras com nomes incluídos pelo filtro com base em regex especificado serão instrumentadas. As regras com o prefixo "-" são excluídas. Apenas regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
- Padrão
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar um ios_application. O resultado é um binário universal contendo todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Obsoleto, substituído por --compatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para mais detalhes). Quando ativado, use --whole-archive para as regras cc_binary que têm linkshared=True e linkstatic=True ou '-static' em linkopts. Isso se aplica apenas à compatibilidade com versões anteriores. Uma alternativa melhor é usar "semprelink=1" quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para passar para o GCC durante a vinculação.
Tags:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de back-end LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de indexação da LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se ela estiver definida e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Se é necessário remover símbolos ou códigos inativos nos binários vinculados. As remoções binárias serão executadas se essa sinalização e --compile_mode=opt forem especificadas.
Tags:action_command_lines
--objccopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir 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>
usos múltiplos foram acumulados-
Outras opções para passar seletivamente ao GCC ao compilar determinados arquivos Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao back-end de LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter representa uma lista de padrões para incluir e excluir expressões regulares. option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 -O0 à linha de comando do back-end LTO de todos os arquivos em //foo/ exceto bar.o.
Tags:action_command_lines
,affects_outputs
- Padrão
--platform_suffix=<a string>
: ver descrição -
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Padrão
--propeller_optimize=<a build target label>
: ver descrição -
Use as informações do perfil da hélice para otimizar o destino da versão.Um perfil de hélice precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Esse sinalizador aceita um rótulo de compilação que deve se referir aos arquivos de entrada do perfil de hélice. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva export_files pode precisar ser adicionada ao pacote correspondente para tornar esses arquivos visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
- Padrão
--propeller_optimize_absolute_cc_profile=<a string>
: ver descrição -
O nome absoluto do caminho do arquivo cc_profile para builds do Propeller Optimized.
Tags:affects_outputs
- Padrão
--propeller_optimize_absolute_ld_profile=<a string>
: ver descrição -
Nome absoluto do caminho do arquivo ld_profile para builds otimizados para a hélice.
Tags:affects_outputs
- Padrão
--run_under=<a prefix in front of command>
: ver 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".Ela também pode ser um rótulo para um destino executável. Alguns exemplos são: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tags:action_command_lines
-
Se for verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Marque os binários com data, nome de usuário, nome do host, informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se é necessário remover binários e bibliotecas compartilhadas (usando "-Wl,--strip-debug"). O valor padrão de "às vezes" significa strip iff --compile_mode=fastbuild.
Tags:affects_outputs
--stripopt=<a string>
usos múltiplos foram acumulados-
Opções adicionais a serem transmitidas para a faixa ao gerar um binário "<name>.stripped".
Tags:action_command_lines
,affects_outputs
--swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir para a compilação do Swift.
Tags:action_command_lines
- Padrão
--symlink_prefix=<a string>
: ver descrição -
O prefixo anexado a qualquer um dos symlinks de conveniência criados após uma compilação. Se omitido, o valor padrão é o nome da ferramenta de build seguido de um hífen. Se "/" for passado, nenhum link simbólico será criado e nenhum aviso será emitido. Aviso: a funcionalidade especial para '/' será desativada em breve; em vez dela, use --experimental_convenience_symlinks=ignore.
Tags:affects_outputs
--tvos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar binários do tvOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Versão mínima do tvOS compatível para simuladores e dispositivos de destino. Se não for especificado, usará 'tvos_sdk_version'.
Tags:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgula para as quais criar binários watchOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
- Padrão
--xbinary_fdo=<a build target label>
: ver descrição -
Use as informações do perfil 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 como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--auto_cpu_environment_group=<a build target label>
padrão: ""-
Declare o ambiente_grupo a ser usado para mapear automaticamente os valores de CPU para os valores de "target_environment".
Tags:changes_inputs
,loading_and_analysis
,experimental
--[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 em dependências de destino são rebaixados a avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Se quer simplificar o bytecode Java 8 antes da dexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Inclui se as bibliotecas Java 8 compatíveis serão incluídas nos apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com os quais cada destino é compatível e relata erros se algum destino tiver dependências que não são compatíveis com os mesmos ambientes
Tags:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
padrão: "false"-
Sinaliza para ajudar na transição de permitir a não permitir regras android_library sem src com dependências. É necessário limpar o armazenamento para que ele seja implantado por padrão.
Tags:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
padrão: "true"-
Se deve verificar a simplificação correta no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
padrão: "DESATIVADO"-
Quando ativada, verifique se as dependências de um aar_import estão completas. Essa aplicação pode corromper a versão ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se a opção estiver ativada, verifique somente os destinos de pré-requisito que são arquivos de saída procurando a regra de teste somente da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações do conjunto 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 Android do Starlark em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Ambiente autônomo. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
padrão: "true"-
Se ativada, defina a verificação de cabeçalho rígida nas APIs Starlark
Tags:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 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]incompatible_validate_top_level_header_inclusions
padrão: "true"-
Se verdadeiro, o Bazel também validará as inclusões de cabeçalho de diretório de nível superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para mais informações).
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_native_rules_allowlist=<a build target label>
: ver descrição - Uma lista de permissões (destino de group_group) a ser usada ao aplicar --compatible_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 relatados como erros. Ele não funciona quando check_fileset_dependencies_recursively está desativado.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em 'importar público' como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados pelo sistema incluem caminhos (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
usos múltiplos foram acumulados-
Declara o ambiente de destino dessa versão. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido, e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
- Padrão
--ios_signing_cert_name=<a string>
: ver descrição -
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado novamente. Pode ser a preferência de identidade do conjunto de chaves do certificado ou (substring) do nome comum do certificado, conforme a página do manual do signo (SIGNING IDENTITIES).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, .bzl ou WORKSPACE:
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se compatible_enforce_config_setting_visibility=false, isso é um ambiente autônomo. Caso contrário, se essa sinalização for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa sinalização for verdadeira, config_setting seguirá a mesma lógica de visibilidade que todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
O ambiente autônomo será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permite os atributos sdk_frameworks e fraca_sdk_frameworks em objc_library andobjc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplicará as restrições de visibilidade config_setting. Se falso, todos os config_setting ficarão visíveis para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, torne o valor padrão verdadeiro para os atributos sempre do link em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, ocorre um erro ao usar as regras py_* integradas. Em vez disso, use as regras rule_python. Consulte https://github.com/bazelbuild/bazel/issues/17773 para ver 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 verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo que contém a descrição do erro, em vez de resultar em uma falha de versão.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas por meio de um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite resultará em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiras falhas de ação do dex2oat causarem falha na compilação em vez de executar o dex2oat durante o tempo de execução de teste.
Tags:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
padrão: "false"-
Não execute testes, apenas se eles estão atualizados. Se todos os resultados dos testes estiverem atualizados, eles serão concluídos com sucesso. Se algum teste precisar ser criado ou executado, um erro será relatado e o teste falhará. Essa opção implica um comportamento --check_up_to_date.
Tags:execution
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para possivelmente acelerar android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
usos múltiplos foram acumulados-
Cada teste será repetido até o número especificado de vezes em caso de falha. Os testes que precisam de mais de uma tentativa de aprovação são marcados como "FLAKY" no resumo de testes. Normalmente, o valor especificado é apenas um número inteiro ou a string "padrão". Se for um número inteiro, todos os testes serão executados até N vezes. Se for "default", apenas uma tentativa de teste será feita para os testes regulares, e três para aqueles marcados explicitamente como inconsistentes pela regra (atributo "flaky=1"). Sintaxe alternativa: regex_filter@flaky_test_attempts. Em que flaky_test_attempts é como acima e regex_filter significa uma lista de incluir e excluir padrões de expressão regular (Consulte também --runs_per_test). Exemplo: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 desfaz todos os testes em //foo/, exceto os que estão em foo/bar três vezes. Essa opção pode ser passada várias vezes. O argumento passado mais recentemente que corresponde tem precedência. Se nada corresponder, o comportamento será como "padrão" acima.
Tags:execution
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória nos destinos ios_test.
Tags:action_command_lines
- Padrão
--ios_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do iOS que será executada no simulador durante a execução ou teste. Isso será ignorado em regras de ios_test se um dispositivo de destino for especificado na regra.
Tags:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
padrão: "auto"-
O número máximo de jobs de teste locais a serem executados simultaneamente. Toma 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 limitarão o número de jobs de teste local a serem executados simultaneamente. Definir este valor acima do valor para --jobs não é eficaz.
Tags:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
usos múltiplos foram acumulados- Especifica o número de vezes que o teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, todo o teste será considerado com falha. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 executará todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Onde run_per_test representa o valor inteiro e regex_filter representa uma lista de padrões para incluir e excluir expressões regulares (também consulte --instrumentation_filter). Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto os que estão em foo/bar três vezes. Essa opção pode ser passada várias vezes. O argumento passado 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>
usos múltiplos foram acumulados-
Especifica outras variáveis de ambiente a serem injetadas no ambiente de execução do teste. As variáveis podem ser especificadas por nome, caso em que seu valor será lido no ambiente de cliente do Bazel ou pelo par name=value. Essa opção pode ser usada várias vezes para especificar diversas variáveis. Usado apenas pelo comando "bazel test".
Tags:test_runner
--[no]test_keep_going
padrão: "true"-
Quando desativado, qualquer teste que não seja aprovado fará com que toda a versão seja interrompida. 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_timeout=<a single integer or comma-separated list of 4 integers>
padrão: "-1"- Substitui os valores padrão de tempo limite para testes (em segundos). Se um único valor inteiro positivo for especificado, ele substituirá todas as categorias. Se forem especificados quatro números inteiros separados por vírgula, eles substituirão os limites de tempo curto, moderado, longo e eterno (nessa ordem). Em qualquer formato, o valor -1 instrui o blaze a usar seus tempos limite padrão para essa categoria.
- Padrão
--test_tmpdir=<a path>
: ver descrição - Especifica o diretório temporário base para o "teste do bazel" usar.
- Padrão
--tvos_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo tvOS no simulador, por exemplo, "Apple TV 1080p". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do tvOS a ser executada no simulador durante a execução ou teste.
Tags:test_runner
- Padrão
--watchos_simulator_device=<a string>
: ver descrição -
O dispositivo que será simulado ao executar um aplicativo watchOS no simulador, por exemplo, "Apple Watch - 38 mm". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do watchOS para execução no simulador durante a execução ou teste.
Tags:test_runner
--[no]zip_undeclared_test_outputs
padrão: "true"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções que acionam otimizações do tempo de compilação:
--[no]collapse_duplicate_defines
padrão: "true"-
Quando ativada, a opção --defines é removida no início da versão. Isso evita a perda desnecessária do cache de análise para determinados tipos de builds equivalentes.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProGuard ProgramJar para remover todas as classes que também estão no LibraryJar.
Tags:action_command_lines
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativado, os arquivos .d de C++ serão transmitidos na memória diretamente dos nós do build remoto em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados pelas compilações em Java serão transmitidos na memória diretamente dos nós de compilação remota, em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
padrão: "false"-
Realize a verificação de inclusão para C/C++ objetivo.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativada, --trim_test_configuration não cortará a configuração de teste das regras marcadas como testonly=1. Isso visa reduzir problemas de conflito de ação quando as regras não relacionadas a teste dependem das regras cc_test. Nenhum efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import pode ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Para refinar as entradas para a compilação C/C++ analisando #include linhas dos arquivos de entrada. Isso pode melhorar o desempenho e a incrementabilidade diminuindo o tamanho das árvores de entrada de compilação. No entanto, ela também pode corromper 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. Qualquer problema relacionado a este sinalizador que será registrado será encerrado.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
padrão: "true"-
Faz a maior parte do trabalho de dexação separadamente para cada arquivo Jar.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para remover 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 dos quais //a:a depende (se o processamento do cabeçalho estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativadas, as opções relacionadas a testes serão limpas abaixo do nível superior do build. Quando essa sinalização está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as alterações nas opções relacionadas a testes não farão com que as regras que não são de teste sejam analisadas novamente.
Tags:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
padrão: "true"-
Esta opção está obsoleta. Agora é um ambiente autônomo e será removido em breve.
Tags:loading_and_analysis
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]announce
padrão: "false"-
Obsoleto. Ambiente autônomo.
Tags:affects_outputs
--[no]experimental_bep_target_summary
padrão: "false"- Se os eventos TargetSummary serão publicados.
--[no]experimental_build_event_expand_filesets
padrão: "false"-
Se verdadeiro, expanda Filesets no BEP ao apresentar arquivos de saída.
Tags:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
padrão: "false"-
Se verdadeiro, resolve totalmente os links simbólicos do conjunto de arquivos relativo no BEP ao apresentar arquivos de saída. Requer --experimental_build_event_expand_filesets.
Tags:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
padrão: "4"-
O número máximo de vezes que o Bazel tentará fazer o upload de um evento de versão novamente.
Tags:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
padrão: "1s"-
Atraso inicial inicial para novas tentativas de retirada exponencial quando o upload do BEP falha. (expoente: 1.6)
Tags:bazel_internal_configuration
- Padrão
--experimental_build_event_upload_strategy=<a string>
: ver descrição -
Seleciona como fazer upload de artefatos referenciados no protocolo de eventos de build.
Tags:affects_outputs
--[no]experimental_materialize_param_files_directly
padrão: "false"-
Se materializar arquivos de parâmetros, faça isso com gravações diretas no disco.
Tags:execution
--[no]experimental_stream_log_file_uploads
padrão: "false"-
Faça o upload dos arquivos de registros por streaming diretamente para o armazenamento remoto, em vez de gravá-los em disco.
Tags:affects_outputs
- Padrão
--explain=<a path>
: ver descrição -
Faz com que o sistema de compilação explique cada etapa executada. A explicação é gravada no arquivo de registros especificado.
Tags:affects_outputs
--[no]legacy_important_outputs
padrão: "true"-
Use-o para suprimir a geração do campo "important_outputs" legado no evento TargetComplete. Essa função é necessária para a integração do Bazel à ResultStore.
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 para depurar ações. Isso está implícito em --subcommands e --verbose_failures.
Tags:execution
--max_config_changes_to_show=<an integer>
padrão: "3"-
Ao descartar o cache de análise devido a uma mudança nas opções de build, são exibidos até o número indicado 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 um resultado de teste excessivamente ruidoso. O cabeçalho de teste está incluído no tamanho do registro. Valores negativos não implicam limite. A saída é tudo ou nada.
Tags:test_runner
,terminal_output
,execution
- Padrão
--output_filter=<a valid Java regular expression>
: ver descrição -
Mostra apenas avisos de regras com um nome correspondente à expressão regular fornecida.
Tags:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
padrão: "0"-
O número de segundos entre os relatórios de 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 depois desse progresso uma vez a cada minuto. Quando --curses está ativado, o progresso é reportado a cada segundo.
Tags:affects_outputs
--show_result=<an integer>
padrão: "1"-
Mostra os resultados do build. Para cada destino, indique se ele foi atualizado e, em caso afirmativo, uma lista de arquivos de saída que foram criados. Os arquivos impressos são strings práticas para copiar e colar no shell e executá-los.
Esta opção requer um argumento de número inteiro, que é o número limite de destinos acima do qual as informações de resultado não são impressas. Assim, zero causa a supressão da mensagem e MAX_INT faz com que a impressão do resultado ocorra sempre. O padrão é um.
Se nada foi criado para um destino, os resultados podem ser omitidos para manter a saída abaixo do limite.
Tags:affects_outputs
--[no]subcommands
[-s
] padrão: "false"-
Exibe os subcomandos executados durante uma criação. Sinalizações relacionadas: --execution_log_json_file, --execution_log_binary_file (para o registro de subcomandos em um arquivo em formato compatível com a ferramenta).
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 exibir somente o resumo do status do teste, "errors" para imprimir registros de teste para testes com falha, "all" para imprimir registros de todos os testes e "streamed" para registros de saída para todos os testes em tempo real (isso força os testes a serem executados localmente um de cada vez, independentemente do valor --test_strategy).
Tags:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
padrão: "short"-
Especifica o formato desejado do resumo de teste. Os valores válidos são "curto" para exibir informações somente sobre os testes executados, "terse", para imprimir informações apenas sobre testes malsucedidos que foram executados, "detalhado" para imprimir informações detalhadas sobre casos de teste com falha, "teste" para imprimir o resumo na resolução do caso de teste, "não imprimir" informações detalhadas sobre casos de teste com falha e "nenhum" para omitir o resumo.
Tags:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Imprimir informações de depuração durante a resolução do conjunto de ferramentas. A sinalização usa um regex, verificado em relação aos tipos de conjunto de ferramentas e a destinos específicos para ver qual depurar. Várias regex podem ser separadas por vírgulas e, em seguida, cada regex é verificado separadamente. Observação: a saída dessa sinalização é muito complexa e provavelmente será útil apenas para especialistas na resolução de conjuntos de ferramentas.
Tags:terminal_output
--[no]verbose_explanations
padrão: "false"- Aumenta o detalhamento das explicações emitidas se --explain estiver ativado. Não terá 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>
usos múltiplos foram acumulados-
Especifica os valores dos parâmetros dos aspectos da linha de comando. Cada valor de parâmetro é especificado por meio de <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
--flag_alias=<a 'name=value' flag alias>
usos múltiplos foram acumulados-
Define um nome abreviado para uma sinalização do Starlark. Ele usa um único par de chave-valor no formato "<key>=<value>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa sinalização altera o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos arquivos de execução dos destinos Python. Exatamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa sinalização estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 aparecerão em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 aparecerão em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico "bazel-bin" apontará para os destinos do Python 3 em vez do Python 2. Se você ativar esta opção, também será recomendável ativar `--compatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") são definidos como PY3, em vez de PY2. Se você definir essa sinalização, também será recomendável definir `--compatible_py2_outputs_are_suffixed`.
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como verdadeiro, as regras nativas do Python nativo usarão o ambiente de execução do Python especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução indicado por sinalizações legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_version=<PY2 or PY3>
: ver descrição -
O modo de versão principal do Python, `PY2` ou `PY3`. Ele é substituído por destinos `py_binary` e `py_test` (mesmo que eles não especifiquem explicitamente uma versão). Geralmente, não há muito motivo para fornecer essa sinalização.
Tags:loading_and_analysis
,affects_outputs
,explicit_in_output_path
--target_pattern_file=<a string>
padrão: ""-
Se definida, a versão lerá padrões do arquivo nomeado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como padrões de linha de comando.
Tags:changes_inputs
- Opções de execução e armazenamento em cache remoto:
--experimental_remote_cache_eviction_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de repetição se o build encontrar um erro de remoção de cache remoto. Um valor diferente de zero será definido implicitamente --compatible_remote_use_new_exit_code_for_lost_inputs como verdadeiro.
Tags:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
padrão: "true"-
Se definido como verdadeiro, o Bazel usará o novo código de saída 39 em vez de 34, se o cache remoto remover blobs durante a versão.
Tags:incompatible_change
- Opções diversas, sem outras categorias:
--[no]build_manual_tests
padrão: "false"- Força os destinos de teste marcados como "manual" a serem criados. Testes "manuais" são excluídos do processamento. Essa opção os força a serem criados (mas não executados).
--build_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista de tags separada por vírgulas. Cada tag pode ser precedida por "-" para especificar as tags excluídas. Somente esses destinos serão criados contendo pelo menos uma tag incluída e não contendo nenhuma tag excluída. 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 especificada, apenas 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.
--[no]cache_test_results
[-t
] padrão: "auto"- Se esta configuração for definida como "auto", o Bazel executará um teste novamente se e somente se: (1) o Bazel detectar alterações no teste ou as dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de testes, exceto os marcados como externos. Se definido como "não", o Bazel não armazena em cache nenhum resultado de teste.
--[no]compile_one_dependency
padrão: "false"- Compile uma única dependência dos arquivos de argumentos. Isso é útil para verificar a sintaxe dos arquivos de origem em ambientes de desenvolvimento integrado, 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/criação/teste. Este argumento afeta a forma como todos os argumentos sem sinalização são interpretados. Em vez de serem destinos para compilação, eles são nomes de arquivos de origem. Para cada nome de arquivo de origem, será criado um destino arbitrário que depende dele.
--deleted_packages=<comma-separated list of package names>
usos múltiplos foram acumulados- Uma lista separada por vírgulas de nomes de pacotes que o sistema de compilação considerará inexistente, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use esta opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, após excluir x/y/BUILD de seu cliente, o sistema de compilação pode 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 aproximadamente 10%, mas torna as compilações incrementais mais lentas.
- Padrão
--execution_log_binary_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como protos delimitados de spawn, de acordo com src/main/protobuf/spawn.proto. Primeiro, o registro é gravado de forma não ordenada e, em seguida, no final da invocação, é classificado em uma ordem estável (pode consumir muita CPU e memória). Sinalizadores relacionados: --execution_log_json_file (formato de texto json ordenado), --experimental_execution_log_file (formato protobuf binário não ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
- Padrão
--execution_log_json_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como representação json dos protos delimitados por spawn, de acordo com src/main/protobuf/spawn.proto. Primeiro, o registro é gravado de forma não ordenada e, em seguida, no final da invocação, é classificado em uma ordem estável (pode consumir muita CPU e memória). Sinalizações relacionadas: Sinalizações relacionadas: --execution_log_binary_file (formato protobuf binário ordenado), --experimental_execution_log_file (formato protobuf binário não ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
--[no]execution_log_sort
padrão: "true"- Se é para classificar o registro de execução. Defina como "false" para melhorar o desempenho da memória, mas tenha o custo de produzir o registro em uma ordem não determinística.
--[no]expand_test_suites
padrão: "true"-
Expanda os destinos "test_suite" nos testes constituintes deles antes da análise. Quando essa sinalização estiver ativada (o padrão), os padrões de destino negativos serão aplicados aos testes pertencentes ao conjunto de testes. Caso contrário, não serão. A desativação dessa sinalização é útil quando os aspectos de nível superior são aplicados na linha de comando e podem analisar os destinos test_suite.
Tags:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze cancelará os testes em execução simultânea na primeira execução bem-sucedida. Isso é útil apenas em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
- Padrão
--experimental_execution_log_file=<a path>
: ver descrição - Registre os spawns executados nesse arquivo como protos delimitados de spawn, de acordo com src/main/protobuf/spawn.proto. Esse arquivo é gravado na ordem da execução dos spawns. Sinalizações relacionadas: --execution_log_binary_file (formato protobuf binário ordenado), --execution_log_json_file (formato json de texto ordenado), --subcomandos (para exibir subcomandos na saída do terminal).
--[no]experimental_execution_log_spawn_metrics
padrão: "false"- Inclua métricas de spawn no registro de spawn executado.
--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 segmentações para programar extra_actions.
--[no]experimental_extra_action_top_level_only
padrão: "false"- Obsoleto, substituído por aspectos. Programa apenas extras_actions para segmentações de nível superior.
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca todo o diretório de dados de cobertura para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do Clang gerará um relatório de LCOV.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
padrão: "true"- Gera o mapa de cabeçalho J2ObjC em paralelo com a transcompilação J2ObjC.
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Gerar com caminho de cabeçalho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Ativa caminhos de classe reduzidos para compilações em Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Limite --experimental_run_android_lint_on_java_rules a bibliotecas compatíveis com Android.
Tags:affects_outputs
--[no]experimental_prioritize_local_actions
padrão: "true"-
Se definidas, as ações que podem ser executadas apenas localmente têm primeira chance de adquirir recursos, os workers de execução dinâmica têm uma segunda chance e as ações independentes executadas dinamicamente ficam por último.
Tags:execution
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Valida ou não as origens de java_*.
Tags:affects_outputs
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência para JUnit ou Hamcrest em um java_test, em vez de receber acidentalmente das dependências do TestRunner. No momento, só funciona com o Bazel.
- Padrão
--host_java_launcher=<a build target label>
: ver descrição - A tela de início do Java usada por ferramentas que são executadas durante uma versão.
--host_javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac ao criar ferramentas executadas durante uma compilação.
--host_jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java ao criar ferramentas executadas durante a criação. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel falhará em um teste fragmentado se o executor não indicar que ele é compatível com a fragmentação, tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se falso, um executor de teste que não suporta a fragmentação levará a todos os testes em execução em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia no modo sandbox. Adicione a tag "local" para forçar uma execução exclusiva de um teste local.
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
usos múltiplos foram acumulados- Outras opções para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde a conexão de um depurador compatível com JDWP (como jdb) antes de iniciar o teste. Implica -test_output=streamed.
Expande-se para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gere informações de dependência (por enquanto, classpath no tempo de compilação) por destino em 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
- Padrão
--java_launcher=<a build target label>
: ver descrição - A tela de início do Java a ser usada ao criar binários do Java. Se essa sinalização for definida como a string vazia, a tela de início do JDK será usada. O atributo "launcher" substitui essa sinalização.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução do Java
--javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac.
--jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
- Padrão
--legacy_main_dex_list_generator=<a build target label>
: ver descrição - Especifica um binário para gerar a lista de classes que precisam estar no dex principal ao compilar multidex legado.
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
padrão: "HOST_CPUS"- Defina explicitamente o número total de núcleos de CPU local disponíveis para o Bazel gastar em ações de compilação executadas localmente. Usa um número inteiro, ou "HOST_CPUS", opcionalmente seguido de [-|*]<float> (por exemplo, HOST_CPUS*.5 para usar metade dos núcleos de CPU disponíveis).Por padrão, ("HOST_CPUS"), o Bazel consultará a configuração do sistema para estimar o número de núcleos de CPU disponíveis.
--local_extra_resources=<a named float, 'name=value'>
usos múltiplos foram acumulados- Defina o número de recursos extras disponíveis para o Bazel. Recebe um par de flutuação de string. Pode ser usado várias vezes para especificar vários tipos de recursos extras. O Bazel limitará as ações em execução simultânea com base nos recursos extras disponíveis e nos recursos adicionais necessários. Os testes podem declarar a quantidade de recursos extras necessários usando uma tag no formato "resources:<resoucename>:<amount>" CPU, RAM e recursos disponíveis não podem ser definidos com esta sinalização.
--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 compilação executadas localmente. Toma 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 consultará a configuração do sistema para estimar a quantidade de RAM disponível e usará 67% dela.
--local_termination_grace_seconds=<an integer>
padrão: "15"- Tempo de espera entre o encerramento de um processo local devido ao tempo limite e encerramento forçado.
- Padrão
--optimizing_dexer=<a build target label>
: ver descrição - Especifica um binário para ser usado na dexação sem fragmentação.
--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 incluído. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--plugin=<a build target label>
usos múltiplos foram acumulados- Plug-ins a serem usados no build. Atualmente, funciona com java_plugin.
- Padrão
--proguard_top=<a build target label>
: ver descrição - Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do proto-compilador.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos de C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do Java.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags:affects_outputs
,loading_and_analysis
--protocopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa passe e pelo menos uma execução/tentativa falhe terá um status FLAKY.
- Padrão
--shell_executable=<a path>
: ver descrição -
O caminho absoluto para o executável do shell a ser usado pelo Bazel. Se não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor), ele a usará. Se nenhum deles estiver definido, o Bazel usará um caminho padrão codificado, dependendo do sistema operacional em que for executado (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). Observe que o uso de um shell não compatível com bash pode causar falhas de compilação ou falhas de tempo de execução nos binários gerados.
Tags:loading_and_analysis
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
--test_arg=<a string>
usos múltiplos foram acumulados- Especifica outras opções e argumentos que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles receberá argumentos idênticos. Usado apenas pelo comando "bazel test".
- Padrão
--test_filter=<a string>
: ver descrição - Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução de testes. Isso não afeta quais destinos são criados.
--test_lang_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista separada por vírgulas dos idiomas de teste. Cada idioma pode ser precedido por "-" para especificar os idiomas excluídos. Apenas os destinos de teste que estiverem escritos nos idiomas especificados serão encontrados. O nome usado para cada idioma deve ser o mesmo que o prefixo do idioma na regra *_test, por exemplo, "cc", "java", "py" etc. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--test_result_expiration=<an integer>
padrão: "-1"- Esta opção está obsoleta e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- A opção de encaminhamento falha com rapidez para o executor de teste. O executor de testes deve parar 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: "explícito"- Especifique a estratégia de fragmentação de teste: "explícito" para usar fragmentação apenas se o atributo "BUILD" de "shard_count" estiver presente. "disabled" para nunca usar fragmentação de teste. 'forced=k' para impor os fragmentos 'k' para teste, independentemente do atributo 'shard_count' do BUILD.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
padrão: ""- Especifica uma lista separada por vírgulas de tamanhos de teste. Cada tamanho pode ser precedido por "-" para especificar os tamanhos excluídos. Apenas os destinos de teste que contiverem pelo menos um tamanho incluído e não contiverem tamanhos excluídos. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--test_tag_filters=<comma-separated list of options>
padrão: ""- Especifica uma lista de tags de teste separadas por vírgulas. Cada tag pode ser precedida por "-" para especificar as tags excluídas. Somente os destinos de teste que contiverem pelo menos uma tag incluída e não contiverem tags excluídas serão encontrados. Essa opção afeta o comportamento --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 de tempos limite de teste separados por vírgulas. Cada tempo limite pode ser precedido por "-" para especificar os tempos limite excluídos. Apenas os destinos de teste que contiverem pelo menos um tempo limite incluído e nenhum tempo limite excluído serão exibidos. Essa opção afeta o comportamento --build_tests_only e o comando de teste.
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante uma compilação.
--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 a criação
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso resultará em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de canonização de sinalização
Herda todas as opções de build.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que controlam a saída do comando:
--[no]canonicalize_policy
padrão: "false"-
Saída da política canônica, após a expansão e a filtragem. Para manter a saída limpa, os argumentos de comando canônicos NÃO serão exibidos quando essa opção estiver definida como verdadeira. O comando especificado por --for_command afeta a política filtrada e, se nenhum for especificado, o comando padrão será "build".
Tags:affects_outputs
,terminal_output
--[no]show_warnings
padrão: "false"-
Avisos de analisador de saída para erro padrão (por exemplo, para opções de sinalização conflitantes).
Tags:affects_outputs
,terminal_output
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags do ambiente autônomo
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
padrão: "false"-
Se compatible_enforce_config_setting_visibility=false, isso é um ambiente autônomo. Caso contrário, se essa sinalização for falsa, qualquer config_setting sem um atributo de visibilidade explícito será //visibility:public. Se essa sinalização for verdadeira, config_setting seguirá a mesma lógica de visibilidade que todas as outras regras. Consulte https://github.com/bazelbuild/bazel/issues/12933.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
padrão: "true"-
Se verdadeiro, aplicará as restrições de visibilidade config_setting. Se falso, todos os config_setting ficarão visíveis para cada destino. Consulte https://github.com/bazelbuild/bazel/issues/12932.
Tags:loading_and_analysis
,incompatible_change
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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
--for_command=<a string>
padrão: "build"-
O comando em que as opções precisam ser canonizadas.
Tags:affects_outputs
,terminal_output
--invocation_policy=<a string>
padrão: ""-
Aplica uma política de invocação às opções a serem canonizadas.
Tags:affects_outputs
,terminal_output
- Opções de armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--deleted_packages=<comma-separated list of package names>
usos múltiplos foram acumulados- Uma lista separada por vírgulas de nomes de pacotes que o sistema de compilação considerará inexistente, mesmo que estejam visíveis em algum lugar no caminho do pacote. Use esta opção ao excluir um subpacote "x/y" de um pacote "x" existente. Por exemplo, após excluir x/y/BUILD de seu cliente, o sistema de compilação pode 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.
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--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 incluído. Se omitido ou vazio, o padrão é a saída de "bazel info default-package-path".
--[no]show_loading_progress
padrão: "true"- Se ativado, faz com que o Bazel imprima mensagens "Carregando pacote:".
Opções de limpeza
Herda todas as opções de build.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que controlam a saída do comando:
--[no]async
padrão: "false"-
Se verdadeiro, a limpeza de 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 verdadeiro, remove toda a árvore de trabalho da instância do Bazel, o que inclui todos os arquivos de saída temporários e de compilação criados pelo Bazel, e interrompe o servidor do Bazel se ele estiver em execução.
Tags:host_machine_resource_optimizations
--expunge_async
-
Se especificada, a limpeza remove de maneira assíncrona toda a árvore de trabalho da instância do Bazel, que inclui todos os arquivos de saída temporários e de compilação 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-se como:
--expunge
--async
Tags:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
padrão: "false"-
Se verdadeiro, todos os links simbólicos no espaço de trabalho com o prefixo symlink_prefix serão excluídos. Sem essa sinalização, apenas links simbólicos com os sufixos predefinidos são limpos.
Tags:affects_outputs
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags Op
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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 armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
Opções de configuração
Opções de cobertura
Herda todas as opções de test.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags Op
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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 armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
Opções de consulta
Herda todas as opções de test.
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags de ambiente autônomo
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica de consultas:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é {xml,proto,record}. "off" significa que nenhuma dependência de aspectos é resolvida, "conservadora" (o padrão) significa que todas as dependências declaradas são adicionadas, independentemente de terem recebido a classe de regra de dependências diretas, "preciso" significa que apenas os aspectos que são possivelmente ativos são adicionados, possivelmente dada a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, tornando-o mais lento do que os outros modos. Observe também que o modo preciso não é completamente preciso: a decisão de computar um aspecto é decidida na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido " fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos deles serão concatenados. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O tamanho máximo da string de rótulo para um nó de gráfico na saída. Marcadores mais longos ficarão truncados. -1 significa sem truncamento. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita é aquela que não está explicitamente especificada no arquivo BUILD, mas adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--[no]include_aspects
padrão: "true"- aquery, cquery: se serão incluídas ações geradas por aspecto na saída. query: no-op (aspectos são sempre seguidos).
Tags:terminal_output
--[no]incompatible_display_source_file_location
padrão: "true"-
Verdadeiro por padrão, mostra o destino do arquivo de origem. Se verdadeiro, exibe o local da linha 1 dos arquivos de origem nas saídas do local. Essa sinalização existe apenas para fins de migração.
Tags:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo `packages` do package_group, o `//` principal não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se "set" e "-universe_scope" não forem definidos, um valor de "--verse" será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo universal (por exemplo, `allrdeps`) pode não ser o que você quer. Portanto, use essa opção apenas se souber o que está fazendo. Consulte 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: esta opção se aplica somente a "consulta" (ou seja, não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Se cada formato é terminado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativada, as dependências dos atributos "nodep" serão incluídas no gráfico de dependência em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de compilação.
Tags:build_file_semantics
--output=<a string>
padrão: "label"-
O formato em que os resultados da consulta precisam ser impressos. Os valores permitidos para cquery são: label, label_kind, textproto, transições, 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 verdadeiro, os atributos com valor não especificado explicitamente no arquivo BUILD são incluídos. Caso contrário, são omitidos. Essa opção é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto define_stack, que registra para cada instância de regra a pilha de chamadas Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativada, os atributos configuráveis criados por select() são simplificados. Para tipos de lista, a representação nivelada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulo.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo do proto source_aspect_name de cada Atributo com o aspecto de origem do atributo (string vazia se não tiver sido).
Tags:terminal_output
--[no]proto:include_configurations
padrão: "true"-
se ativada, a saída proto incluirá informações sobre configurações. Quando desativado,o formato de saída do proto da consulta é semelhante ao formato de saída da consulta.
Tags:affects_outputs
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Calcular ou não o atributo $internal_attr_hash.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Se é preciso enviar informações de local na saída proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "todos"-
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 é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Se os campos regra_entrada e regra_saída serão ou não preenchidos.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definida, a consulta lerá a consulta no arquivo chamado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, a localização dos arquivos BUILD em saídas xml e proto será relativa. Por padrão, a saída do local é um caminho absoluto e não será consistente entre as máquinas. Você pode definir essa opção como verdadeira para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--show_config_fragments=<off, direct or transitive>
padrão: "desativado"-
Mostra os fragmentos de configuração exigidos por uma regra e as dependências transitivas dele. Isso pode ser útil para avaliar o quanto um gráfico de destino configurado pode ser cortado.
Tags:affects_outputs
--starlark:expr=<a string>
padrão: ""-
Uma expressão Starlark para formatar cada destino configurado no modo --output=starlark da consulta. O destino configurado está vinculado ao "destino". Se nem --starlark:expr nem --starlark:file for especificado, essa opção assumirá como 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 de --output=starlark para obter mais detalhes.
Tags:terminal_output
--[no]tool_deps
padrão: "true"-
Consulta: se desativada, as dependências na "configuração exec" não serão incluídas no gráfico de dependência em que a consulta opera. Uma borda de dependência de "configuração de execução", como a de qualquer regra de "proto_library" para o Compilador de protocolos, normalmente aponta para uma ferramenta executada durante a versão, e não como parte de um mesmo programa de "destino".
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 destinos configurados que também estão na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração exec, somente destinos configurados por executivos serão retornados. Esta opção NÃO excluirá os conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--transitions=<full, lite or none>
padrão: "nenhum"-
O formato em que o cquery imprimirá informações de transição.
Tags:affects_outputs
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino separados por vírgula (aditivo e subtrativo). A consulta pode ser realizada no universo definido pelo fechamento transitivo dos destinos especificados. Essa opção é usada para os comandos query e cquery.
Para cquery, a entrada para essa 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: se essa opção não for especificada, o build poderá corromper a compilação se os destinos analisados na expressão de consulta não forem criados com opções de nível superior.
Tags:loading_and_analysis
- Opções relacionadas à saída e à semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (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 dos módulos do Bazel. Os valores válidos são `error`, para levá-lo a uma falha de resolução, `off`, para desativar a verificação, ou `warning` para imprimir um aviso quando uma correspondência não é 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ências resolvida. Os valores válidos são "off" para desativar a verificação, "warning" para exibir um aviso quando uma incompatibilidade é detectada ou "error" para encaminhar o problema a uma falha de resolução.
Tags:loading_and_analysis
--[no]ignore_dev_dependency
padrão: "false"-
Se verdadeiro, o Bazel ignora "bazel_dep" e "use_extension" declarados como "dev_dependency" no módulo MODULE.bazel do módulo raiz. Observe que essas dependências de desenvolvimento sempre são ignoradas no MODULE.bazel se não for o módulo raiz, independentemente do valor dessa sinalização.
Tags:loading_and_analysis
--lockfile_mode=<off, update or error>
padrão: "desativado"-
Especifica como usar ou não o arquivo de bloqueio. Os valores válidos são "atualizar" para usar o arquivo de bloqueio e atualizá-lo se houver alterações, "erro" para usar o arquivo de bloqueio, mas gerar um erro se não estiver atualizado ou "desativar" para não ler ou gravar no arquivo de bloqueio.
Tags:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
usos múltiplos foram acumulados- Modifique um módulo com um caminho local na forma de <nome do módulo>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele é relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
--registry=<a string>
usos múltiplos foram acumulados-
Especifica os registros a serem usados para localizar as dependências do módulo do Bazel. A ordem é importante: os módulos serão pesquisados primeiro nos registros anteriores e só serão substituídos pelos registros posteriores quando estiverem ausentes dos anteriores.
Tags:changes_inputs
- Opções que acionam otimizações do tempo de compilação:
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
padrão: ""-
Limites que, se atingidos, fazem com que o GcThrashingDetector falhe com o Bazel com um OOM. Cada limite é especificado como <period>:<count>, em que period é uma duração e count é um número inteiro positivo. Se mais de --experimental_oom_more_eagerly_threshold porcento do espaço permanecido (montagem de geração antiga) permanecer ocupado após <count> GCs consecutivas consecutivas dentro de <período>, uma OOM será acionada. Vários limites podem ser especificados separados por vírgulas.
Tags:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
padrão: "true"-
Se verdadeiro, especificar --experimental_gc_thrashing_limits não vazio desativa o KeepedHeapLimiter para torná-lo mutuamente exclusivo com GcThrashingDetector. Se ela for definida como falsa, ambas poderão ser ativadas para o mesmo comando.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que seu uso de porcentagem de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um evento de GC completo, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos completos de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando ocorrer um evento de GC completo e o limite de porcentagem de heap retida for excedido.
Tags:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
padrão: "2147483647"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso percentual de heap retida excede o limite definido por --skyframe_high_water_mark_threshold, quando ocorrer um pequeno evento de GC, ele descartará o estado temporário temporário do Skyframe até o número de invocações. Assume como padrão Integer.MAX_VALUE; efetivamente ilimitado. Zero significa que eventos menores de coleta de lixo não acionarão quedas. Se o limite for atingido, o estado do Skyframe não será mais descartado quando um evento menor de GC ocorrer 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"- Sinalização para configuração avançada do mecanismo Skyframe interno do Bazel. Se o Bazel detectar que o uso da porcentagem de heap retida está pelo menos nesse limite, ele descartará o estado temporário temporário do Skyframe. Isso pode permitir que você reduza o impacto do tempo decorrido de sobrecarga da GC quando a sobrecarga de GC for (i) causada pelo uso da memória desse estado temporário e (ii) mais cara do que reconstituir o estado quando necessário.
Tags:host_machine_resource_optimizations
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--[no]experimental_command_profile
padrão: "false"- Registra um perfil de CPU do Java Flight Recorder em um arquivo profile.jfr no diretório base de saída. A sintaxe e a semântica dessa sinalização podem mudar no futuro para oferecer suporte a diferentes tipos de perfil ou formatos de saída. Use por sua conta e risco.
--[no]experimental_record_metrics_for_all_mnemonics
padrão: "false"- Por padrão, o número de tipos de ação é limitado aos 20 mnemônicos com o maior número de ações executadas. A definição dessa opção gravará estatísticas para todos os elementos mnemônicos.
- Opções que especificam ou alteram uma entrada genérica em 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 armazenamento em cache e execução remota:
- Padrão
--experimental_downloader_config=<a string>
: ver descrição - Especifique um arquivo para configurar o download remoto. Esse arquivo consiste em linhas, cada uma começando com uma diretiva ("allow", "block" ou "rewrite") seguida por um nome de host (para "allow" e "block") ou dois padrões, um para corresponder e um para usar como um URL substituto, com referências anteriores a "$1". É possível que várias diretivas "rewrite" para o mesmo URL sejam fornecidas e, nesse caso, vários URLs serão retornados.
--experimental_worker_for_repo_fetching=<off, platform or virtual>
padrão: "desativado"- O modo de linha de execução a ser usado para busca do repositório. Se definido como "off", nenhuma linha de execução de worker é usada, e a busca de repo está sujeita a reinicializações. Caso contrário, usa um thread de plataforma (ou seja, um thread de SO) se definido como "platform" ou um thread virtual se definido como "virtual".
- Opções diversas, não categorizadas de outra forma:
--override_repository=<an equals-separated mapping of repository name to path>
usos múltiplos foram acumulados- Substitua um repositório com um caminho local na forma de <nome do repositório>=<caminho>. Se o caminho fornecido for absoluto, ele será usado como está. Se for um caminho relativo, ele é relativo ao diretório de trabalho atual. Se o caminho especificado começar com "%workspace%", ele será relativo à raiz do espaço de trabalho, que é a saída do "bazel info workspace".
- Opções que controlam a execução do build:
--[no]experimental_inprocess_symlink_creation
padrão: "false"-
Se é para fazer chamadas diretas do sistema de arquivos para criar árvores de links simbólicos
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
padrão: "false"-
Se as ações do manifesto de origem precisam ser remotas
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
padrão: "false"-
Se verdadeiro, o Bazel executará o pós-processamento de cobertura para teste em um novo spawn.
Tags:execution
--[no]experimental_strict_fileset_output
padrão: "false"-
Se essa opção estiver ativada, os conjuntos de arquivos tratarão todos os artefatos de saída como arquivos comuns. Eles não cruzam diretórios nem são sensíveis a links simbólicos.
Tags:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
padrão: ""-
Adicione ou remova chaves das informações de execução de uma ação com base no mnemônico da ação. Aplica-se apenas a ações compatíveis com informações de execução. Muitas ações comuns aceitam informações de execução, por exemplo, Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Ao especificar vários valores, a ordem é importante porque muitas regex podem se aplicar ao mesmo mnemônico.
Sintaxe: "regex=[+-]chave,regex=[+-]chave,...".
Exemplos:
".*=+x,.*=-y,.*=+z" adiciona "x" e "z" às informações de execução de todas as ações e remove "y".
"Genrule=+requires-x" adiciona "requires-x" às informações de execução para todas as ações da regra de regra.
'(?!Genrule).*=-requires-x' remove 'requires-x' das informações de execução de todas as ações que não são da Generule.
Tags:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Permita ações de dex e desugar permanentes do Android usando workers.
Expande-se para:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tags:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Ativa o processador de recursos permanente do Android usando workers.
Expande-se para:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
{14/
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Permite ações dex e multiplex persistentes do Android usando workers.
Expande-se para:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Ativa o processador de recursos multiplexados persistentes do Android usando workers.
Expande-se 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
{14/
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Ativa ferramentas Android persistentes e multiplexadas (dexação, simplificação e processamento de recursos).
Expande-se para:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tags:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
padrão: "false"-
Se verdadeiro, o Bazel usará a plataforma de destino para executar testes em vez do grupo executivo de teste.
Tags:execution
- Opções que configuram o conjunto de ferramentas usado para a execução da ação:
- Padrão
--android_compiler=<a string>
: ver descrição -
O compilador de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
padrão: "//external:android/crosstool"-
O local do compilador C++ usado para builds do Android.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--android_grte_top=<a label>
: ver descrição -
O destino Android grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
padrão: "android"-
Seleciona a combinação de manifesto a ser usada para as regras android_binary. Sinalização para ajudar na transição do manifesto legado para a combinação do manifesto do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
padrão: ""-
Define as plataformas que os destinos android_binary usam. Se várias plataformas forem especificadas, o binário será um APK multiarquitetura, que contém binários nativos para cada plataforma de destino especificada.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
padrão: "@bazel_tools//tools/android:sdk"-
Especifica o SDK/a plataforma Android usados para criar apps Android.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--apple_compiler=<a string>
: ver descrição -
O compilador de destino da Apple. Útil para selecionar variantes de um conjunto de ferramentas (por exemplo, xcode-beta).
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote crosstool a ser usado nas regras da Apple e Objc e as dependências delas.
Tags:loses_incremental_state
,changes_inputs
- Padrão
--apple_grte_top=<a build target label>
: ver descrição -
A segmentação da Apple grte_top.
Tags:changes_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
padrão: ""-
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:affects_outputs
,explicit_in_output_path
- Padrão
--compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para compilar o destino.
Tags:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
padrão: "@bazel_tools//tools/test:lcov_merger"-
Local do binário usado para pós-processar os relatórios de cobertura brutos. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:lcov_merger".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_report_generator"-
Local do binário usado para gerar relatórios de cobertura. No momento, deve ser um grupo de arquivos que contenha um único arquivo, o binário. O padrão é "//tools/test:coverage_report_generator".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
padrão: "@bazel_tools//tools/test:coverage_support"-
Local dos arquivos de suporte necessários nas entradas de cada ação de teste que coleta a cobertura do código. O padrão é "//tools/test:coverage_support".
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
padrão: "@bazel_tools//tools/cpp:toolchain"-
O rótulo do pacote entre ferramentas a ser usado para compilar o código C++.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--custom_malloc=<a build target label>
: ver descrição -
Especifica uma implementação personalizada de malloc. Essa configuração substitui os atributos malloc nas regras de compilação.
Tags:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
usos múltiplos foram acumulados-
Lista de expressões regulares separadas por vírgula, cada uma opcionalmente prefixada por - (expressão negativa), atribuída (=) a uma lista de segmentações de valores de restrição separados por vírgulas. Se um destino não corresponder a nenhuma expressão negativa e pelo menos uma expressão positiva, a resolução do conjunto de ferramentas será executada como se tivesse declarado os valores de restrição como restrições de execução. Exemplo: //demo,-test=@platforms//cpus:x86_64 adicionará "x86_64" a qualquer destino em //demo, exceto para aqueles cujo nome contenha "test".
Tags:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
padrão: "true"-
Permite que as regras de objc_* dependam da cc_library e que qualquer dependência do objc seja criada com --cpu definido como "ios_<--ios_cpu>" para quaisquer valores em --ios_multi_cpu.
Tags:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
padrão: "false"-
Se definida, adicione um requisito de execução "requires-xcode:{version}" a cada ação do Xcode. Se a versão 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
--[no]experimental_prefer_mutual_xcode
padrão: "true"-
Caso verdadeiro, use o Xcode mais recente, disponível localmente e remotamente. Se for falso ou se não houver versões mútuas disponíveis, use a versão local do Xcode, selecionada via xcode-select.
Tags:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
padrão: ""-
As plataformas disponíveis para execução de ações. As plataformas podem ser especificadas pelo destino exato ou como um padrão de destino. Essas plataformas serão consideradas antes daquelas declaradas no arquivo WORKSPACE por register_execution_platforms(). Essa opção só pode ser definida uma vez. Instâncias posteriores substituirão as configurações de sinalização anteriores.
Tags:execution
--extra_toolchains=<comma-separated list of options>
usos múltiplos foram acumulados-
As regras do conjunto de ferramentas a serem consideradas durante a resolução do conjunto de ferramentas. Os conjuntos de ferramentas podem ser especificados por destino exato ou como 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
- Padrão
--grte_top=<a label>
: ver descrição -
Um rótulo para uma biblioteca libc de entrada. O valor padrão é selecionado pelo conjunto de ferramentas de várias ferramentas, e você quase nunca precisa substituí-lo.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_compiler=<a string>
: ver descrição -
O compilador C++ a ser usado para a compilação do host. Ela será ignorada se --host_crosstool_top não estiver definido.
Tags:loading_and_analysis
,execution
- Padrão
--host_crosstool_top=<a build target label>
: ver descrição -
Por padrão, as opções --crosstool_top e --compiler também são usadas na configuração exec. Se essa sinalização for fornecida, o Bazel usará a libc e o compilador padrão para o crosstool_top fornecido.
Tags:loading_and_analysis
,changes_inputs
,affects_outputs
- Padrão
--host_grte_top=<a label>
: ver descrição -
Se especificada, esta configuração substitui o diretório de nível superior libc (--grte_top) para a configuração exec.
Tags:action_command_lines
,affects_outputs
--host_platform=<a build target label>
padrão: "@local_config_platform//:host"-
O rótulo de uma regra de plataforma que descreve o sistema host.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
padrão: "true"-
Se verdadeiro, o Bazel não permitirá especificar expand_if_all_available em flag_sets(consulte https://github.com/bazelbuild/bazel/issues/7008 para instruções de migração).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
padrão: "true"-
Se verdadeiro, o Bazel não ativará os recursos "host" e "nonhost" no conjunto 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_android_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK do Android para regras do Android (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
padrão: "false"-
Use a resolução do conjunto de ferramentas para selecionar o SDK da Apple para regras da Apple (Starlark e nativo)
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
padrão: "true"-
Se verdadeiro, o Bazel não reutilizará linhas de comando de ação de link C++ para linhas de comando de indexação lto. Consulte https://github.com/bazelbuild/bazel/issues/6791 para mais informações.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_linking_info_migration
padrão: "true"-
Se verdadeiro, as regras integradas do ObjC vão receber as informações de vinculação do CcInfo em vez do ObjcProvider. Veja mais detalhes e informações sobre a migração em https://github.com/bazelbuild/bazel/issues/16939
Tags:loading_and_analysis
,changes_inputs
eincompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
padrão: "true"-
Se verdadeiro, o Bazel reclamará quando os atributos cc_toolchain.cpu e cc_toolchain.compiler forem definidos (consulte as instruções de migração em https://github.com/bazelbuild/bazel/issues/7075).
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
padrão: "true"-
Se verdadeiro, o Bazel não vinculará dependências de biblioteca como arquivo inteiro por padrão. Consulte https://github.com/bazelbuild/bazel/issues/7362 para ver instruções de migração.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
padrão: "true"-
Se verdadeiro, o Bazel exigirá o parâmetro "ctx" em cc_common.configure_features. Para mais informações, acesse https://github.com/bazelbuild/bazel/issues/7793.
Tags:loading_and_analysis
,incompatible_change
-
Use objetos compartilhados na interface se compatível com o conjunto de ferramentas. No momento, todos os conjuntos de ferramentas ELF são compatíveis com essa configuração.
Tags:loading_and_analysis
,affects_outputs
eaffects_outputs
- Padrão
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do iOS que será usada para criar aplicativos para iOS. Se não for especificado, usará a versão padrão do SDK para iOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do macOS que será usada para criar aplicativos para macOS. Se não for especificado, usará a versão padrão do SDK do macOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--minimum_os_version=<a string>
: ver descrição -
A versão mínima do sistema operacional que sua compilação segmenta.
Tags:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
padrão: ""-
O local de um arquivo de mapeamento que descreve qual plataforma usar se nenhuma estiver definida ou quais sinalizações definir quando já houver uma plataforma. Precisa ser relativo à raiz principal do espaço de trabalho. O padrão é "platform_mappings" (um arquivo diretamente abaixo da raiz do espaço de trabalho).
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
padrão: ""-
Os rótulos das regras de plataforma que descrevem as plataformas de destino do comando atual.
Tags:affects_outputs
,changes_inputs
,loading_and_analysis
- Padrão
--python2_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python3_path=<a string>
: ver descrição -
Obsoleto, ambiente autônomo. Desativado por "--compatible_use_python_toolchains".
Tags:no_op
,deprecated
- Padrão
--python_path=<a string>
: ver descrição -
O caminho absoluto do interpretador do Python invocado para executar destinos do Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--python_top=<a build target label>
: ver descrição -
O rótulo de um py_runtime que representa o interpretador de Python invocado para executar destinos em Python na plataforma de destino. Obsoleto. Desativado por --compatible_use_python_toolchains.
Tags:loading_and_analysis
,affects_outputs
- Padrão
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do tvOS a ser usada para criar aplicativos tvOS. Se não for especificado, usará a versão padrão do SDK tvOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Especifica a versão do SDK do watchOS que vai ser usada para criar apps watchOS. Se não for especificado, usará a versão padrão do SDK watchOS de "xcode_version".
Tags:loses_incremental_state
- Padrão
--xcode_version=<a string>
: ver descrição -
Se especificada, usa o Xcode da versão fornecida para ações de build relevantes. Se não for especificado, usará a versão padrão do executor do Xcode.
Tags:loses_incremental_state
--xcode_version_config=<a build target label>
padrão: "@bazel_tools//tools/cpp:host_xcodes"-
O rótulo da regra xcode_config a ser usado para selecionar a versão do Xcode na configuração do build.
Tags:loses_incremental_state
,loading_and_analysis
- Opções que controlam a saída do comando:
--[no]apple_enable_auto_dsym_dbg
padrão: "false"-
Se há força para ativar a geração de arquivos de símbolo de depuração (.dSYM) para builds do dbg.
Tags:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
padrão: "false"-
Se os arquivos de símbolos de depuração (.dSYM) serão gerados ou não.
Tags:affects_outputs
,action_command_lines
--[no]build_runfile_links
padrão: "true"-
Se verdadeiro, cria runfiles symlink Forests para todos os destinos. Se for falso, escreva apenas manifestos quando possível.
Tags:affects_outputs
--[no]build_runfile_manifests
padrão: "true"-
Se verdadeiro, grava manifestos de arquivos de execução para todos os destinos. Se falso, omiti-los. A execução dos testes locais falhará se ela for falsa.
Tags:affects_outputs
--[no]build_test_dwp
padrão: "false"-
Se ativado, ao compilar testes de C++ estaticamente e com fissão, o arquivo .dwp do binário de teste também será criado automaticamente.
Tags:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
padrão: ".pb.h"-
Define os prefixos dos arquivos principais criados por cc_proto_library.
Tags:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
padrão: ".pb.cc"-
Define os prefixos dos arquivos de origem que uma cc_proto_library cria.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
padrão: "false"-
Execute mais ações para versões alternativas da API Java em uma proto_library.
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
padrão: "false"-
Execute mais ações 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"-
Salvar o estado de recursos ativados e solicitados como uma saída de compilação.
Tags:affects_outputs
,experimental
--fission=<a set of compilation modes>
padrão: "não"-
Especifica quais modos de compilação usam a fissão para compilações e links em C++. Pode ser qualquer combinação de {'fastbuild', 'dbg', 'opt'} ou os valores especiais 'yes' para ativar todos os modos e 'no' para desativar todos os modos.
Tags:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
padrão: "true"-
Se verdadeiro, as regras nativas adicionam <code>DefaultInfo.files</code> de dependências de dados aos arquivos de execução, o que corresponde ao comportamento recomendado para regras Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tags:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
padrão: "true"-
Se for verdadeiro, crie florestas de links simbólicos para arquivos externos em repositórios .runfiles/wsname/external/repo (além de .runfiles/repo).
Tags:affects_outputs
--[no]objc_generate_linkmap
padrão: "false"-
Especifica se é necessário gerar um arquivo de linkmap.
Tags:affects_outputs
--[no]save_temps
padrão: "false"-
Se definido, as saídas temporárias do gcc serão salvas. Isso inclui arquivos .s (código do assembler), arquivos .i (C pré-processado) e arquivos .ii (C++ pré-processado).
Tags:affects_outputs
- Opções que permitem ao usuário configurar a saída pretendida, afetando o valor, em vez da existência:
--action_env=<a 'name=value' assignment with an optional value part>
usos múltiplos foram acumulados-
Especifica o conjunto de variáveis de ambiente disponíveis para ações com a configuração de destino. As variáveis podem ser especificadas por nome, caso em que o valor será obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serão acumuladas.
Tags:action_command_lines
--android_cpu=<a string>
padrão: "armeabi-v7a"-
A CPU de destino do Android.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
padrão: "false"-
Gere arquivos de vinculação de dados compatíveis com o AndroidX. Isso é usado apenas com a vinculação de dados v2.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
padrão: "false"-
Use a vinculação de dados do Android v2 com o argumento 3.4.0
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
padrão: "desativado"- Determina se dependências de C++ de regras do Android serão vinculadas dinamicamente quando um cc_binary não cria explicitamente uma biblioteca compartilhada. "padrão" significa que o Bazel escolherá a vinculação de forma dinâmica. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
padrão: "alfabético"-
Define a ordem dos manifestos transmitidos à combinação de manifestos para binários do Android. ALPHABETICAL significa que os manifestos são classificados por caminho em relação à 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 anterior aos manifestos das dependências.
Tags:action_command_lines
,execution
--[no]android_resource_shrinking
padrão: "false"-
Ativa a redução de recursos para APKs android_binary que usam o ProGuard.
Tags:affects_outputs
,loading_and_analysis
--[no]build_python_zip
padrão: "auto"-
Crie o zip executável do Python. No Windows, desative em outras plataformas.
Tags:affects_outputs
--catalyst_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas 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 instrumentará o código (usando instrumentação off-line sempre que possível) e coletará informações de cobertura durante os testes. Apenas as segmentações que correspondem a --instrumentation_filter serão afetadas. Normalmente, essa opção não deve ser especificada diretamente. O comando "bazel cover" deve ser usado.
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
,explicit_in_output_path
--conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir para o GCC ao compilar arquivos de origem em C.
Tags:action_command_lines
,affects_outputs
--copt=<a string>
usos múltiplos foram acumulados-
Outras opções para passar para o GCC.
Tags:action_command_lines
,affects_outputs
--cpu=<a string>
padrão: ""-
A CPU de destino.
Tags:changes_inputs
,affects_outputs
,explicit_in_output_path
- Padrão
--cs_fdo_absolute_path=<a string>
: ver descrição -
Use as informações do perfil do CSFDO para otimizar a compilação. Especifique o nome do caminho absoluto do arquivo ZIP que contém o arquivo de perfil, um arquivo de perfil bruto ou indexado do LLVM.
Tags:affects_outputs
- Padrão
--cs_fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação de 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 descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--cs_fdo_profile=<a build target label>
: ver descrição -
O cs_fdo_profile que representa o perfil sensível de contexto a ser usado para otimização.
Tags:affects_outputs
--cxxopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transferir para gcc ao compilar arquivos de origem em C++.
Tags:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
usos múltiplos foram acumulados-
Cada opção --define especifica uma atribuição para uma variável de versão.
Tags:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
padrão: "default"-
Determina se os binários C++ serão vinculados dinamicamente. "padrão" significa que o Bazel vinculará dinamicamente. "totalmente" significa que todas as bibliotecas serão vinculadas dinamicamente. "off" significa que todas as bibliotecas serão vinculadas no modo estático.
Tags:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
padrão: "true"-
Se definido, o uso de fdo_absolute_profile_path gerará um erro.
Tags:affects_outputs
--[no]enable_runfiles
padrão: "auto"-
Ativa a árvore de links simbólicos dos arquivos de execução. Por padrão, ela fica desativada no Windows e em outras plataformas.
Tags:affects_outputs
--experimental_action_listener=<a build target label>
usos múltiplos foram acumulados-
Obsoleto, substituído por aspectos. Use action_listener para anexar uma extra_action a ações de versão existentes.
Tags:execution
,experimental
--[no]experimental_android_compress_java_resources
padrão: "false"-
Compacte recursos Java em APKs
Tags:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
padrão: "false"-
Use a vinculação de dados do Android v2
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
--[no]experimental_android_rewrite_dexes_with_rex
padrão: "false"-
usar a ferramenta rex para reescrever arquivos dex
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,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 verdadeiro, use libunwind para liberar a pilha e compile com tabelas -fomit-frame-pointer e -fasynchronous-unwind.
Tags:action_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
padrão: "false"-
Se verdadeiro, a plataforma de destino é usada no nome do diretório de saída em vez da CPU.
Tags:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
padrão: "false"-
Se especificada, o Bazel gera informações do mapa de cobertura llvm-cov em vez de gcov quando a função collection_code_coverage está ativada.
Tags:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated set of options>
padrão: "armeabi-v7a"-
Definir essa opção ativa APKs multiarquitetura, que contêm binários nativos para todas as arquiteturas de destino especificadas, por exemplo, --fat_apk_cpu=x86,armeabi-v7a. Se essa sinalização for especificada, --android_cpu será ignorado para dependências de regras android_binary.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
padrão: "false"-
Se quer criar divisões HWASAN.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Padrão
--fdo_instrument=<a string>
: ver descrição -
Gere binários com a instrumentação FDO. Com o compilador Clang/LLVM, ele também aceita o nome do diretório em que os arquivos de perfil brutos serão descartados no tempo de execução.
Tags:affects_outputs
- Padrão
--fdo_optimize=<a string>
: ver descrição -
Use as informações do perfil do FDO para otimizar a compilação. Especifique o nome de um arquivo ZIP contendo uma árvore de arquivos .gcda, um arquivo afdo que contenha um perfil automático ou um arquivo de perfil LLVM. Essa sinalização também aceita arquivos especificados como marcadores (por exemplo, `//foo/bar:file.afdo` - pode ser necessário adicionar uma diretiva `exports_files` ao pacote correspondente) e marcadores apontando para destinos `fdo_profile`. Essa sinalização será substituída pela regra "fdo_profile".
Tags:affects_outputs
- Padrão
--fdo_prefetch_hints=<a build target label>
: ver descrição -
Use as dicas de pré-busca de cache.
Tags:affects_outputs
- Padrão
--fdo_profile=<a build target label>
: ver descrição -
O fdo_profile que representa o perfil a ser usado para otimização.
Tags:affects_outputs
--features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão nos destinos criados na configuração deles. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos. Veja também --host_features
Tags:changes_inputs
,affects_outputs
--[no]force_pic
padrão: "false"-
Se ativado, todas as compilações C++ produzem código independente de posição ("-fPIC"), os links preferem bibliotecas pré-criadas PIC em vez de bibliotecas não-PIC, e links 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>
usos múltiplos foram 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á obtido do ambiente de invocação, ou pelo par name=value que define o valor independentemente do ambiente de invocação. Essa opção pode ser usada várias vezes. Para as opções fornecidas para a mesma variável, as últimas vitórias e as opções para variáveis diferentes serã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 integradas. Valores: 'fastbuild', 'dbg', 'opt'.
Tags:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
usos múltiplos foram acumulados-
Outra opção para transmitir ao compilador C ao compilar arquivos de origem em C, mas não em C++, nas configurações de execução.
Tags:action_command_lines
,affects_outputs
--host_copt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C as ferramentas criadas nas configurações exec.
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>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador C++ as ferramentas criadas nas configurações exec.
Tags:action_command_lines
,affects_outputs
--host_features=<a string>
usos múltiplos foram acumulados-
Os recursos serão ativados ou desativados por padrão para os destinos criados na configuração exec. Especificar -<feature> desativa o recurso. Os recursos negativos sempre substituem os positivos.
Tags:changes_inputs
,affects_outputs
- Padrão
--host_force_python=<PY2 or PY3>
: ver 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>
usos múltiplos foram acumulados-
Outra opção para transmitir ao vinculador ao vincular ferramentas nas configurações exec.
Tags:action_command_lines
,affects_outputs
- Padrão
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao compilador C/C++ ao compilar determinados arquivos nas configurações do executivo. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da linha de comando -O0 à linha de comando gcc de todos os arquivos cc em //foo/, exceto bar.cc.
Tags:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir um arquivo swiftc a ferramentas exec.
Tags:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
padrão: "false"-
Quando ativado, um grupo executivo é criado automaticamente para cada conjunto de ferramentas usado por uma regra. Para que isso funcione, a regra precisa especificar o parâmetro `toolchain` em suas ações. Para mais informações, consulte https://github.com/bazelbuild/bazel/issues/17134.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_avoid_conflict_dlls
padrão: "true"-
Se ativado, todas as bibliotecas dinâmicas dinâmicas C++ (DLLs, na sigla em inglês) geradas por cc_library no Windows serão renomeadas como name_{hash}.dll, em que o hash é calculado com base no nome do repositório e no caminho do pacote da DLL. Essa opção é útil quando você tem um pacote que depende de vários cc_library com o mesmo nome (por exemplo, //foo/bar1:utils e //foo/bar2:utils).
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
padrão: "true"-
Se verdadeiro, o diretório "genfiles" será dobrado no diretório "bin".
Tags:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
padrão: "false"-
Se for verdadeiro, use --features apenas para a configuração de destino e --host_features para a configuração exec.
Tags:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
padrão: "false"-
Quando a cobertura está ativada, especifica se é necessário considerar a instrumentação das regras de teste. Quando definido, as regras de teste incluídas por --instrumentation_filter são instrumentadas. Caso contrário, as regras de teste sempre serão 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 estiver ativada, somente as regras com nomes incluídos pelo filtro com base em regex especificado serão instrumentadas. As regras com o prefixo "-" são excluídas. Apenas regras que não são de teste são instrumentadas, a menos que --instrument_test_targets esteja ativado.
Tags:affects_outputs
- Padrão
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar um ios_application. O resultado é um binário universal contendo todas as arquiteturas especificadas.
Tags:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
padrão: "true"-
Obsoleto, substituído por --compatible_remove_legacy_whole_archive (consulte https://github.com/bazelbuild/bazel/issues/7362 para mais detalhes). Quando ativado, use --whole-archive para as regras cc_binary que têm linkshared=True e linkstatic=True ou '-static' em linkopts. Isso se aplica apenas à compatibilidade com versões anteriores. Uma alternativa melhor é usar "semprelink=1" quando necessário.
Tags:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para passar para o GCC durante a vinculação.
Tags:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de back-end LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
usos múltiplos foram acumulados-
Opção adicional para transmitir à etapa de indexação da LTO (em --features=thin_lto).
Tags:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista separada por vírgulas de arquiteturas para as quais criar binários do Apple macOS.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
--[no]objc_debug_with_GLIBCXX
padrão: "false"-
Se ela estiver definida e o modo de compilação estiver definido como "dbg", defina GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC e GLIBCPP_CONCEPT_CHECKS.
Tags:action_command_lines
--[no]objc_enable_binary_stripping
padrão: "false"-
Se é necessário remover símbolos ou códigos inativos nos binários vinculados. As remoções binárias serão executadas se essa sinalização e --compile_mode=opt forem especificadas.
Tags:action_command_lines
--objccopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir 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>
usos múltiplos foram acumulados-
Outras opções para passar seletivamente ao GCC ao compilar determinados arquivos Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter significa uma lista de padrões para incluir e excluir expressões regulares (consulte também --instrumentation_filter). option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 da 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>
usos múltiplos foram acumulados-
Outras opções para transmitir seletivamente ao back-end de LTO (em --features=thin_lto) ao compilar determinados objetos de back-end. Essa opção pode ser passada várias vezes. Sintaxe: regex_filter@option_1,option_2,...,opção_n. Em que regex_filter representa uma lista de padrões para incluir e excluir expressões regulares. option_1 para option_n significa opções de linha de comando arbitrárias. Se uma opção contiver uma vírgula, ela precisará estar entre aspas invertidas. 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 -O0 à linha de comando do back-end LTO de todos os arquivos em //foo/ exceto bar.o.
Tags:action_command_lines
,affects_outputs
- Padrão
--platform_suffix=<a string>
: ver descrição -
Especifica um sufixo a ser adicionado ao diretório de configuração.
Tags:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Padrão
--propeller_optimize=<a build target label>
: ver descrição -
Use as informações do perfil da hélice para otimizar o destino da versão.Um perfil de hélice precisa consistir em pelo menos um dos dois arquivos, um perfil cc e um perfil ld. Esse sinalizador aceita um rótulo de compilação que deve se referir aos arquivos de entrada do perfil de hélice. Por exemplo, o arquivo BUILD que define o rótulo, em a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Uma diretiva export_files pode precisar ser adicionada ao pacote correspondente para tornar esses arquivos visíveis para o Bazel. A opção precisa ser usada como: --propeller_optimize=//a/b:propeller_profile
Tags:action_command_lines
,affects_outputs
- Padrão
--propeller_optimize_absolute_cc_profile=<a string>
: ver descrição -
O nome absoluto do caminho do arquivo cc_profile para builds do Propeller Optimized.
Tags:affects_outputs
- Padrão
--propeller_optimize_absolute_ld_profile=<a string>
: ver descrição -
Nome absoluto do caminho do arquivo ld_profile para builds otimizados para a hélice.
Tags:affects_outputs
- Padrão
--run_under=<a prefix in front of command>
: ver 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".Ela também pode ser um rótulo para um destino executável. Alguns exemplos são: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tags:action_command_lines
-
Se for verdadeiro, as bibliotecas nativas que contêm funcionalidades idênticas serão compartilhadas entre diferentes destinos
Tags:loading_and_analysis
,affects_outputs
--[no]stamp
padrão: "false"-
Marque os binários com data, nome de usuário, nome do host, informações do espaço de trabalho etc.
Tags:affects_outputs
--strip=<always, sometimes or never>
padrão: "às vezes"-
Especifica se é necessário remover binários e bibliotecas compartilhadas (usando "-Wl,--strip-debug"). O valor padrão de "às vezes" significa strip iff --compile_mode=fastbuild.
Tags:affects_outputs
--stripopt=<a string>
usos múltiplos foram acumulados-
Opções adicionais a serem transmitidas para a faixa ao gerar um binário "<name>.stripped".
Tags:action_command_lines
,affects_outputs
--swiftcopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir para a compilação do Swift.
Tags:action_command_lines
--tvos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgulas para criar binários do tvOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
Versão mínima do tvOS compatível para simuladores e dispositivos de destino. Se não for especificado, usará 'tvos_sdk_version'.
Tags:loses_incremental_state
--watchos_cpus=<comma-separated list of options>
usos múltiplos foram acumulados-
Lista de arquiteturas separadas por vírgula para as quais criar binários watchOS da Apple.
Tags:loses_incremental_state
,loading_and_analysis
- Padrão
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver 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
- Padrão
--xbinary_fdo=<a build target label>
: ver descrição -
Use as informações do perfil 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 como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--auto_cpu_environment_group=<a build target label>
padrão: ""-
Declare o ambiente_grupo a ser usado para mapear automaticamente os valores de CPU para os valores de "target_environment".
Tags:changes_inputs
,loading_and_analysis
,experimental
--[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 em dependências de destino são rebaixados a avisos.
Tags:build_file_semantics
--[no]desugar_for_android
padrão: "true"-
Se quer simplificar o bytecode Java 8 antes da dexação.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
padrão: "false"-
Inclui se as bibliotecas Java 8 compatíveis serão incluídas nos apps para dispositivos legados.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
padrão: "true"-
Verifica os ambientes com os quais cada destino é compatível e relata erros se algum destino tiver dependências que não são compatíveis com os mesmos ambientes
Tags:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
padrão: "false"-
Sinaliza para ajudar na transição de permitir a não permitir regras android_library sem src com dependências. É necessário limpar o armazenamento para que ele seja implantado por padrão.
Tags:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
padrão: "true"-
Se deve verificar a simplificação correta no nível binário do Android.
Tags:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
padrão: "DESATIVADO"-
Quando ativada, verifique se as dependências de um aar_import estão completas. Essa aplicação pode corromper a versão ou apenas resultar em avisos.
Tags:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
padrão: "default"-
Se verdadeiro, verifica se um destino Java declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
padrão: "false"-
Se a opção estiver ativada, verifique somente os destinos de pré-requisito que são arquivos de saída procurando a regra de teste somente da regra de geração. Isso corresponde à verificação de visibilidade.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
padrão: "false"-
Se ativada, a verificação de visibilidade também se aplica às implementações do conjunto 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 Android do Starlark em https://github.com/bazelbuild/rules_android
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
padrão: "false"-
Ambiente autônomo. Mantido aqui para compatibilidade com versões anteriores.
Tags:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
padrão: "true"-
Se ativada, defina a verificação de cabeçalho rígida nas APIs Starlark
Tags:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_python_disable_py2
padrão: "true"-
Se verdadeiro, o uso das configurações do Python 2 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]incompatible_validate_top_level_header_inclusions
padrão: "true"-
Se verdadeiro, o Bazel também validará as inclusões de cabeçalho de diretório de nível superior (consulte https://github.com/bazelbuild/bazel/issues/10047 para mais informações).
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_native_rules_allowlist=<a build target label>
: ver descrição - Uma lista de permissões (destino de group_group) a ser usada ao aplicar --compatible_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 relatados como erros. Ele não funciona quando check_fileset_dependencies_recursively está desativado.
Tags:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
padrão: "error"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados diretamente como dependências.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
padrão: "desativado"-
A menos que esteja DESATIVADO, verifica se um destino proto_library declara explicitamente todos os destinos usados em 'importar público' como exportados.
Tags:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
padrão: "false"-
Se verdadeiro, os cabeçalhos encontrados pelo sistema incluem caminhos (-isystem) também precisam ser declarados.
Tags:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
usos múltiplos foram acumulados-
Declara o ambiente de destino dessa versão. Precisa ser uma referência de rótulo para uma regra de "ambiente". Se especificado, todos os destinos de nível superior precisam ser compatíveis com esse ambiente.
Tags:changes_inputs
- Opções que afetam as saídas de assinatura de um build:
--apk_signing_method=<v1, v2, v1_v2 or v4>
padrão: "v1_v2"-
Implementação para assinar APKs
Tags:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
padrão: "true"-
Se definido, e o modo de compilação não for "opt", os apps objc vão incluir direitos de depuração ao assinar.
Tags:changes_inputs
- Padrão
--ios_signing_cert_name=<a string>
: ver descrição -
Nome do certificado a ser usado para assinatura do iOS. Se não for definido, o perfil de provisionamento será usado novamente. Pode ser a preferência de identidade do conjunto de chaves do certificado ou (substring) do nome comum do certificado, conforme a página do manual do signo (SIGNING IDENTITIES).
Tags:action_command_lines
- Essa opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, .bzl ou WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider
padrão: "true"-
O ambiente autônomo será removido em breve.
Tags:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
padrão: "false"-
Se verdadeiro, não permite os atributos sdk_frameworks e fraca_sdk_frameworks em objc_library andobjc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
padrão: "false"-
Se verdadeiro, torne o valor padrão verdadeiro para os atributos sempre do link em objc_library e objc_import.
Tags:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
padrão: "false"-
Quando verdadeiro, ocorre um erro ao usar as regras py_* integradas. Em vez disso, use as regras rule_python. Consulte https://github.com/bazelbuild/bazel/issues/17773 para ver 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 verdadeiro, uma falha de análise de um destino de regra resulta na propagação do destino de uma instância de AnalysisFailureInfo que contém a descrição do erro, em vez de resultar em uma falha de versão.
Tags:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
padrão: "2000"-
Define o número máximo de dependências transitivas por meio de um atributo de regra com uma transição de configuração for_analysis_testing. Exceder esse limite resultará em um erro de regra.
Tags:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
padrão: "false"-
Se verdadeiras falhas de ação do dex2oat causarem falha na compilação em vez de executar o dex2oat durante o tempo de execução de teste.
Tags:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
padrão: "false"-
Use dex2oat em paralelo para possivelmente acelerar android_test.
Tags:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
padrão: "false"-
Ativa a verificação de vazamentos de memória nos destinos ios_test.
Tags:action_command_lines
- Padrão
--ios_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo iOS no simulador, por exemplo, "iPhone 6". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do iOS que será executada no simulador durante a execução ou teste. Isso será ignorado em regras de 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>
usos múltiplos foram acumulados- Especifica o número de vezes que o teste será executado. Se alguma dessas tentativas falhar por qualquer motivo, todo o teste será considerado com falha. Normalmente, o valor especificado é apenas um número inteiro. Exemplo: --runs_per_test=3 executará todos os testes três vezes. Sintaxe alternativa: regex_filter@runs_per_test. Onde run_per_test representa o valor inteiro e regex_filter representa uma lista de padrões para incluir e excluir expressões regulares (também consulte --instrumentation_filter). Exemplo: --runs_per_test=//foo/.*,-//foo/bar/.*@3 executa todos os testes em //foo/, exceto os que estão em foo/bar três vezes. Essa opção pode ser passada várias vezes. O argumento passado 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>
usos múltiplos foram acumulados-
Especifica outras variáveis de ambiente a serem injetadas no ambiente de execução do teste. As variáveis podem ser especificadas por nome, caso em que seu valor será lido no ambiente de cliente do Bazel ou pelo par name=value. Essa opção pode ser usada várias vezes para especificar diversas 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 para testes (em segundos). Se um único valor inteiro positivo for especificado, ele substituirá todas as categorias. Se forem especificados quatro números inteiros separados por vírgula, eles substituirão os limites de tempo curto, moderado, longo e eterno (nessa ordem). Em qualquer formato, o valor -1 instrui o blaze a usar seus tempos limite padrão para essa categoria.
- Padrão
--tvos_simulator_device=<a string>
: ver descrição -
O dispositivo a ser simulado ao executar um aplicativo tvOS no simulador, por exemplo, "Apple TV 1080p". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do tvOS a ser executada no simulador durante a execução ou teste.
Tags:test_runner
- Padrão
--watchos_simulator_device=<a string>
: ver descrição -
O dispositivo que será simulado ao executar um aplicativo watchOS no simulador, por exemplo, "Apple Watch - 38 mm". É possível obter uma lista de dispositivos executando "xcrun simctl list devicetypes" na máquina em que o simulador será executado.
Tags:test_runner
- Padrão
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ver descrição -
A versão do watchOS para execução no simulador durante a execução ou teste.
Tags:test_runner
--[no]zip_undeclared_test_outputs
padrão: "true"-
Se verdadeiro, as saídas de teste não declaradas serão arquivadas em um arquivo ZIP.
Tags:test_runner
- Opções relacionadas à saída e à semântica da consulta:
--aspect_deps=<off, conservative or precise>
padrão: "conservador"-
Como resolver dependências de aspecto quando o formato de saída é {xml,proto,record}. "off" significa que nenhuma dependência de aspectos é resolvida, "conservadora" (o padrão) significa que todas as dependências declaradas são adicionadas, independentemente de terem recebido a classe de regra de dependências diretas, "preciso" significa que apenas os aspectos que são possivelmente ativos são adicionados, possivelmente dada a classe de regra das dependências diretas. O modo preciso exige o carregamento de outros pacotes para avaliar um único destino, tornando-o mais lento do que os outros modos. Observe também que o modo preciso não é completamente preciso: a decisão de computar um aspecto é decidida na fase de análise, que não é executada durante a "consulta do bazel".
Tags:build_file_semantics
--[no]graph:factored
padrão: "true"-
Se verdadeiro, o gráfico será emitido " fatorado", ou seja, os nós topologicamente equivalentes serão mesclados e os rótulos deles serão concatenados. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--graph:node_limit=<an integer>
padrão: "512"-
O tamanho máximo da string de rótulo para um nó de gráfico na saída. Marcadores mais longos ficarão truncados. -1 significa sem truncamento. Esta opção só é aplicável a --output=graph.
Tags:terminal_output
--[no]implicit_deps
padrão: "true"-
Se ativada, as dependências implícitas serão incluídas no gráfico de dependências em que a consulta opera. Uma dependência implícita é aquela que não está explicitamente especificada no arquivo BUILD, mas adicionada pelo Bazel. Para cquery, essa opção controla a filtragem de conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--[no]include_aspects
padrão: "true"- aquery, cquery: se serão incluídas ações geradas por aspecto na saída. query: no-op (aspectos são sempre seguidos).
Tags:terminal_output
--[no]incompatible_display_source_file_location
padrão: "true"-
Verdadeiro por padrão, mostra o destino do arquivo de origem. Se verdadeiro, exibe o local da linha 1 dos arquivos de origem nas saídas do local. Essa sinalização existe apenas para fins de migração.
Tags:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
padrão: "true"-
Se ativado, ao gerar o atributo `packages` do package_group, o `//` principal não será omitido.
Tags:terminal_output
,incompatible_change
--[no]infer_universe_scope
padrão: "false"-
Se "set" e "-universe_scope" não forem definidos, um valor de "--verse" será inferido como a lista de padrões de destino exclusivos na expressão da consulta. O valor --universe_scope inferido para uma expressão de consulta que usa funções com escopo universal (por exemplo, `allrdeps`) pode não ser o que você quer. Portanto, use essa opção apenas se souber o que está fazendo. Consulte 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: esta opção se aplica somente a "consulta" (ou seja, não a "cquery").
Tags:loading_and_analysis
--[no]line_terminator_null
padrão: "false"-
Se cada formato é terminado com \0 em vez de nova linha.
Tags:terminal_output
--[no]nodep_deps
padrão: "true"-
Se ativada, as dependências dos atributos "nodep" serão incluídas no gráfico de dependência em que a consulta opera. Um exemplo comum de um atributo "nodep" é "visibilidade". Execute e analise a saída de "info build-language" para saber mais sobre todos os atributos "nodep" na linguagem de compilação.
Tags:build_file_semantics
--output=<a string>
padrão: "label"-
O formato em que os resultados da consulta precisam ser impressos. Os valores permitidos para cquery são: label, label_kind, textproto, transições, 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 verdadeiro, os atributos com valor não especificado explicitamente no arquivo BUILD são incluídos. Caso contrário, são omitidos. Essa opção é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:definition_stack
padrão: "false"-
Preencha o campo proto define_stack, que registra para cada instância de regra a pilha de chamadas Starlark no momento em que a classe da regra foi definida.
Tags:terminal_output
--[no]proto:flatten_selects
padrão: "true"-
Se ativada, os atributos configuráveis criados por select() são simplificados. Para tipos de lista, a representação nivelada é uma lista que contém cada valor do mapa selecionado exatamente uma vez. Os tipos escalares são achatados para nulo.
Tags:build_file_semantics
--[no]proto:include_attribute_source_aspects
padrão: "false"-
Preencha o campo do proto source_aspect_name de cada Atributo com o aspecto de origem do atributo (string vazia se não tiver sido).
Tags:terminal_output
--[no]proto:include_configurations
padrão: "true"-
se ativada, a saída proto incluirá informações sobre configurações. Quando desativado,o formato de saída do proto da consulta é semelhante ao formato de saída da consulta.
Tags:affects_outputs
--[no]proto:include_synthetic_attribute_hash
padrão: "false"-
Calcular ou não o atributo $internal_attr_hash.
Tags:terminal_output
--[no]proto:instantiation_stack
padrão: "false"-
Preencha a pilha de chamadas de instanciação de cada regra. Isso requer que a pilha esteja presente
Tags:terminal_output
--[no]proto:locations
padrão: "true"-
Se é preciso enviar informações de local na saída proto.
Tags:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
padrão: "todos"-
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 é aplicável a --output=proto.
Tags:terminal_output
--[no]proto:rule_inputs_and_outputs
padrão: "true"-
Se os campos regra_entrada e regra_saída serão ou não preenchidos.
Tags:terminal_output
--query_file=<a string>
padrão: ""-
Se definida, a consulta lerá a consulta no arquivo chamado aqui, e não na linha de comando. É um erro especificar um arquivo aqui, bem como uma consulta de linha de comando.
Tags:changes_inputs
--[no]relative_locations
padrão: "false"-
Se verdadeiro, a localização dos arquivos BUILD em saídas xml e proto será relativa. Por padrão, a saída do local é um caminho absoluto e não será consistente entre as máquinas. Você pode definir essa opção como verdadeira para ter um resultado consistente em todas as máquinas.
Tags:terminal_output
--show_config_fragments=<off, direct or transitive>
padrão: "desativado"-
Mostra os fragmentos de configuração exigidos por uma regra e as dependências transitivas dele. Isso pode ser útil para avaliar o quanto um gráfico de destino configurado pode ser cortado.
Tags:affects_outputs
--starlark:expr=<a string>
padrão: ""-
Uma expressão Starlark para formatar cada destino configurado no modo --output=starlark da consulta. O destino configurado está vinculado ao "destino". Se nem --starlark:expr nem --starlark:file for especificado, essa opção assumirá como 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 de --output=starlark para obter mais detalhes.
Tags:terminal_output
--[no]tool_deps
padrão: "true"-
Consulta: se desativada, as dependências na "configuração exec" não serão incluídas no gráfico de dependência em que a consulta opera. Uma borda de dependência de "configuração de execução", como a de qualquer regra de "proto_library" para o Compilador de protocolos, normalmente aponta para uma ferramenta executada durante a versão, e não como parte de um mesmo programa de "destino".
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 destinos configurados que também estão na configuração de destino serão retornados. Se o destino de nível superior estiver na configuração exec, somente destinos configurados por executivos serão retornados. Esta opção NÃO excluirá os conjuntos de ferramentas resolvidos.
Tags:build_file_semantics
--transitions=<full, lite or none>
padrão: "nenhum"-
O formato em que o cquery imprimirá informações de transição.
Tags:affects_outputs
--universe_scope=<comma-separated list of options>
padrão: ""-
Um conjunto de padrões de destino separados por vírgula (aditivo e subtrativo). A consulta pode ser realizada no universo definido pelo fechamento transitivo dos destinos especificados. Essa opção é usada para os comandos query e cquery.
Para cquery, a entrada para essa 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: se essa opção não for especificada, o build poderá corromper a compilação se os destinos analisados na expressão de consulta não forem criados com opções de nível superior.
Tags:loading_and_analysis
- Opções que acionam otimizações do tempo de compilação:
--[no]collapse_duplicate_defines
padrão: "true"-
Quando ativada, a opção --defines é removida no início da versão. Isso evita a perda desnecessária do cache de análise para determinados tipos de builds equivalentes.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
padrão: "false"-
Filtre o ProGuard ProgramJar para remover todas as classes que também estão no LibraryJar.
Tags:action_command_lines
--[no]experimental_inmemory_dotd_files
padrão: "true"-
Se ativado, os arquivos .d de C++ serão transmitidos na memória diretamente dos nós do build remoto em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
padrão: "true"-
Se ativado, os arquivos de dependência (.jdeps) gerados pelas compilações em Java serão transmitidos na memória diretamente dos nós de compilação remota, em vez de serem gravados no disco.
Tags:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
padrão: "false"-
Realize a verificação de inclusão para C/C++ objetivo.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
padrão: "false"-
Quando ativada, --trim_test_configuration não cortará a configuração de teste das regras marcadas como testonly=1. Isso visa reduzir problemas de conflito de ação quando as regras não relacionadas a teste dependem das regras cc_test. Nenhum efeito se --trim_test_configuration for falso.
Tags:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
padrão: "false"-
Se ativada, a versão do Starlark de cc_import pode ser usada.
Tags:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
padrão: "false"-
Para refinar as entradas para a compilação C/C++ analisando #include linhas dos arquivos de entrada. Isso pode melhorar o desempenho e a incrementabilidade diminuindo o tamanho das árvores de entrada de compilação. No entanto, ela também pode corromper 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. Qualquer problema relacionado a este sinalizador que será registrado será encerrado.
Tags:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
padrão: "true"-
Faz a maior parte do trabalho de dexação separadamente para cada arquivo Jar.
Tags:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
padrão: "true"-
Se definido, os arquivos .d emitidos pelo clang serão usados para remover 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 dos quais //a:a depende (se o processamento do cabeçalho estiver ativado para o conjunto de ferramentas).
Tags:execution
--[no]trim_test_configuration
padrão: "true"-
Quando ativadas, as opções relacionadas a testes serão limpas abaixo do nível superior do build. Quando essa sinalização está ativa, os testes não podem ser criados como dependências de regras que não são de teste, mas as alterações nas opções relacionadas a testes não farão com que as regras que não são de teste sejam analisadas novamente.
Tags:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
padrão: "true"-
Esta opção está obsoleta. Agora é um ambiente autônomo e será removido em breve.
Tags:loading_and_analysis
- Opções que afetam a verbosidade, o formato ou o local da geração de registros:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: "-.*"-
Imprimir informações de depuração durante a resolução do conjunto de ferramentas. A sinalização usa um regex, verificado em relação aos tipos de conjunto de ferramentas e a destinos específicos para ver qual depurar. Várias regex podem ser separadas por vírgulas e, em seguida, cada regex é verificado separadamente. Observação: a saída dessa sinalização é muito complexa e provavelmente será útil apenas para especialistas na resolução de conjuntos de ferramentas.
Tags:terminal_output
- Opções que especificam ou alteram uma entrada genérica para um comando do Bazel que não se enquadra em outras categorias:
--flag_alias=<a 'name=value' flag alias>
usos múltiplos foram acumulados-
Define um nome abreviado para uma sinalização do Starlark. Ele usa um único par de chave-valor no formato "<key>=<value>" como argumento.
Tags:changes_inputs
--[no]incompatible_default_to_explicit_init_py
padrão: "false"-
Essa sinalização altera o comportamento padrão para que os arquivos __init__.py não sejam mais criados automaticamente nos arquivos de execução dos destinos Python. Exatamente, quando um destino py_binary ou py_test tem legacy_create_init definido como "auto" (padrão), ele é tratado como falso se e somente se essa sinalização estiver definida. Consulte https://github.com/bazelbuild/bazel/issues/10076.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
padrão: "true"-
Se verdadeiro, os destinos criados na configuração do Python 2 aparecerão em uma raiz de saída que inclui o sufixo "-py2", enquanto os destinos criados para o Python 3 aparecerão em uma raiz sem sufixo relacionado ao Python. Isso significa que o link simbólico "bazel-bin" apontará para os destinos do Python 3 em vez do Python 2. Se você ativar esta opção, também será recomendável ativar `--compatible_py3_is_default`.
Tags:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
padrão: "true"-
Se verdadeiro, os destinos "py_binary" e "py_test" que não definem o atributo "python_version" (ou "default_python_version") são definidos como PY3, em vez de PY2. Se você definir essa sinalização, também será recomendável definir `--compatible_py2_outputs_are_suffixed`.
Tags:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
padrão: "true"-
Se definido como verdadeiro, as regras nativas do Python nativo usarão o ambiente de execução do Python especificado pelo conjunto de ferramentas do Python, em vez do ambiente de execução indicado por sinalizações legadas, como --python_top.
Tags:loading_and_analysis
,incompatible_change
- Padrão
--python_version=<PY2 or PY3>
: ver descrição -
O modo de versão principal do Python, `PY2` ou `PY3`. Ele é substituído por destinos `py_binary` e `py_test` (mesmo que eles não especifiquem explicitamente uma versão). Geralmente, não há muito motivo para fornecer essa sinalização.
Tags:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opções diversas, não categorizadas de outra forma:
--[no]cache_test_results
[-t
] padrão: "auto"- Se esta configuração for definida como "auto", o Bazel executará um teste novamente se e somente se: (1) o Bazel detectar alterações no teste ou as dependências dele, (2) o teste for marcado como externo, (3) várias execuções de teste tiverem sido solicitadas com --runs_per_test ou(4) o teste falhou anteriormente. Se definido como "sim", o Bazel armazena em cache todos os resultados de testes, exceto os marcados como externos. Se definido como "não", o Bazel não armazena em cache nenhum resultado de teste.
--[no]experimental_cancel_concurrent_tests
padrão: "false"-
Se verdadeiro, o Blaze cancelará os testes em execução simultânea na primeira execução bem-sucedida. Isso é útil apenas em combinação com --runs_per_test_detects_flakes.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
padrão: "false"-
Se verdadeiro, o Bazel busca todo o diretório de dados de cobertura para cada teste durante uma execução de cobertura.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
padrão: "false"-
Se verdadeiro, a cobertura do Clang gerará um relatório de LCOV.
Tags:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
padrão: "true"- Gera o mapa de cabeçalho J2ObjC em paralelo com a transcompilação J2ObjC.
--[no]experimental_j2objc_shorter_header_path
padrão: "false"-
Gerar com caminho de cabeçalho mais curto (usa "_ios" em vez de "_j2objc").
Tags:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
padrão: "javabuilder"- Ativa caminhos de classe reduzidos para compilações em Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
padrão: "false"-
Limite --experimental_run_android_lint_on_java_rules a bibliotecas compatíveis com Android.
Tags:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
padrão: "false"-
Valida ou não as origens de java_*.
Tags:affects_outputs
--[no]explicit_java_test_deps
padrão: "false"- Especifique explicitamente uma dependência para JUnit ou Hamcrest em um java_test, em vez de receber acidentalmente das dependências do TestRunner. No momento, só funciona com o Bazel.
- Padrão
--host_java_launcher=<a build target label>
: ver descrição - A tela de início do Java usada por ferramentas que são executadas durante uma versão.
--host_javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac ao criar ferramentas executadas durante uma compilação.
--host_jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java ao criar ferramentas executadas durante a criação. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
--[no]incompatible_check_sharding_support
padrão: "true"-
Se verdadeiro, o Bazel falhará em um teste fragmentado se o executor não indicar que ele é compatível com a fragmentação, tocando no arquivo no caminho em TEST_SHARD_STATUS_FILE. Se falso, um executor de teste que não suporta a fragmentação levará a todos os testes em execução em cada fragmento.
Tags:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
padrão: "true"-
Se verdadeiro, os testes exclusivos serão executados com a estratégia no modo sandbox. Adicione a tag "local" para forçar uma execução exclusiva de um teste local.
Tags:incompatible_change
--[no]incompatible_strict_action_env
padrão: "false"-
Se verdadeiro, o Bazel usa um ambiente com um valor estático para PATH e não herda LD_LIBRARY_PATH. Use --action_env=ENV_VARIABLE se quiser herdar variáveis de ambiente específicas do cliente. No entanto, isso pode impedir o armazenamento em cache entre usuários se um cache compartilhado for usado.
Tags:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
usos múltiplos foram acumulados- Outras opções para transmitir à ferramenta J2ObjC.
--java_debug
-
Faz com que a máquina virtual Java de um teste Java aguarde a conexão de um depurador compatível com JDWP (como jdb) antes de iniciar o teste. Implica -test_output=streamed.
Expande-se para:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
padrão: "true"- Gere informações de dependência (por enquanto, classpath no tempo de compilação) por destino em 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
- Padrão
--java_launcher=<a build target label>
: ver descrição - A tela de início do Java a ser usada ao criar binários do Java. Se essa sinalização for definida como a string vazia, a tela de início do JDK será usada. O atributo "launcher" substitui essa sinalização.
--java_runtime_version=<a string>
padrão: "local_jdk"- A versão do ambiente de execução do Java
--javacopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir ao javac.
--jvmopt=<a string>
usos múltiplos foram acumulados- Outras opções para transmitir à VM do Java. Essas opções serão adicionadas às opções de inicialização da VM de cada destino java_binary.
- Padrão
--legacy_main_dex_list_generator=<a build target label>
: ver descrição - Especifica um binário para gerar a lista de classes que precisam estar no dex principal ao compilar multidex legado.
- Padrão
--optimizing_dexer=<a build target label>
: ver descrição - Especifica um binário para ser usado na dexação sem fragmentação.
--plugin=<a build target label>
usos múltiplos foram acumulados- Plug-ins a serem usados no build. Atualmente, funciona com java_plugin.
- Padrão
--proguard_top=<a build target label>
: ver descrição - Especifica qual versão do ProGuard usar para a remoção de código ao criar um binário Java.
--proto_compiler=<a build target label>
padrão: "@bazel_tools//tools/proto:protoc"-
O rótulo do proto-compilador.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
padrão: "@bazel_tools//tools/proto:cc_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos de C++
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
padrão: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos j2objc
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
padrão: "@bazel_tools//tools/proto:java_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do Java.
Tags:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
padrão: "@bazel_tools//tools/proto:javalite_toolchain"-
Rótulo de proto_lang_toolchain() que descreve como compilar protos do JavaLite
Tags:affects_outputs
,loading_and_analysis
--protocopt=<a string>
usos múltiplos foram acumulados-
Outras opções para transmitir ao compilador protobuf.
Tags:affects_outputs
--[no]runs_per_test_detects_flakes
padrão: "false"- Se verdadeiro, qualquer fragmento em que pelo menos uma execução/tentativa passe e pelo menos uma execução/tentativa falhe terá um status FLAKY.
- Padrão
--shell_executable=<a path>
: ver descrição -
O caminho absoluto para o executável do shell a ser usado pelo Bazel. Se não estiver definida, mas a variável de ambiente BAZEL_SH estiver definida na primeira invocação do Bazel (que inicia um servidor), ele a usará. Se nenhum deles estiver definido, o Bazel usará um caminho padrão codificado, dependendo do sistema operacional em que for executado (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, todos os outros: /bin/bash). Observe que o uso de um shell não compatível com bash pode causar falhas de compilação ou falhas de tempo de execução nos binários gerados.
Tags:loading_and_analysis
--test_arg=<a string>
usos múltiplos foram acumulados- Especifica outras opções e argumentos que precisam ser transmitidos para o executável de teste. Pode ser usado várias vezes para especificar vários argumentos. Se vários testes forem executados, cada um deles receberá argumentos idênticos. Usado apenas pelo comando "bazel test".
- Padrão
--test_filter=<a string>
: ver descrição - Especifica um filtro para encaminhar ao framework de teste. Usado para limitar a execução de testes. Isso não afeta quais destinos são criados.
--test_result_expiration=<an integer>
padrão: "-1"- Esta opção está obsoleta e não tem efeito.
--[no]test_runner_fail_fast
padrão: "false"- A opção de encaminhamento falha com rapidez para o executor de teste. O executor de testes deve parar 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: "explícito"- Especifique a estratégia de fragmentação de teste: "explícito" para usar fragmentação apenas se o atributo "BUILD" de "shard_count" estiver presente. "disabled" para nunca usar fragmentação de teste. 'forced=k' para impor os fragmentos 'k' para teste, independentemente do atributo 'shard_count' do BUILD.
--tool_java_language_version=<a string>
padrão: ""- A versão da linguagem Java usada para executar as ferramentas necessárias durante uma compilação.
--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 a criação
--[no]use_ijars
padrão: "true"- Se ativada, essa opção faz com que a compilação Java use jars de interface. Isso resultará em uma compilação incremental mais rápida, mas as mensagens de erro podem ser diferentes.
Opções de despejo
- Opções que aparecem antes do comando e são analisadas pelo cliente:
--distdir=<a path>
usos múltiplos foram acumulados-
Outros locais para pesquisar arquivos antes de acessar a rede para fazer o download deles.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
padrão: "false"-
Se definido, o cache do repositório vinculará o arquivo em caso de ocorrência em cache, em vez de copiar. Isso economiza espaço em disco.
Tags:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
padrão: "false"-
Se verdadeiro, usa uma string derivada dos URLs de downloads do repositório como o canonical_id, se não especificado. Isso faz com que uma alteração nos URLs resulte em um novo download, mesmo que o cache tenha um download com o mesmo hash. Isso pode ser usado para verificar se as alterações de URL não resultam em mascaramento de repositórios corrompidos pelo cache.
Tags:loading_and_analysis
,experimental
--experimental_repository_downloader_retries=<an integer>
padrão: "0"-
O número máximo de tentativas de fazer o download de um erro. Se definido como 0, as tentativas serão desativadas.
Tags:experimental
--experimental_scale_timeouts=<a double>
padrão: "1.0"-
Escalone todos os tempos limite nas regras do repositório do Starlark de acordo com esse fator. Dessa forma, os repositórios externos podem funcionar em máquinas mais lentas do que o autor da regra, sem mudar o código-fonte
Tags:bazel_internal_configuration
,experimental
--http_connector_attempts=<an integer>
padrão: "8"-
O número máximo de tentativas de download de 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 de http. Com um valor de 0, nenhum tempo limite máximo é definido.
Tags:bazel_internal_configuration
--http_timeout_scaling=<a double>
padrão: "1.0"-
Escalone todos os tempos limite relacionados aos downloads de HTTP com base no fator especificado.
Tags:bazel_internal_configuration
- Padrão
--repository_cache=<a path>
: ver descrição -
Especifica o local do cache dos valores transferidos por download durante a busca de repositórios externos. Uma string vazia como argumento solicita a desativação do cache. Caso contrário, o padrão "<output_user_root>/cache/repos/v1" é usado.
Tags:bazel_internal_configuration
--[no]repository_disable_download
padrão: "false"-
Se definida, o download usando ctx.download{,_and_extract} não será permitido durante a busca de repositório. O acesso à rede não está completamente desativado. O 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 da compilação:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
padrão: "100"-
Se essa sinalização for definida como um valor menor que 100, o Bazel vai OOM se, após duas GCs completas, mais de uma porcentagem do heap (geração antiga) ainda estiver ocupada.
Tags:host_machine_resource_optimizations
- Opções que controlam a saída do comando:
--[no]action_cache
padrão: "false"-
Dumpe o conteúdo do cache de ação.
Tags:bazel_monitoring
--[no]packages
padrão: "false"-
Despeja o conteúdo do cache do pacote.
Tags:bazel_monitoring
--[no]rule_classes
padrão: "false"-
Dump classes de regra.
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, deps or rdeps>
padrão: "desativado"-
Gráfico de despejo do Skyframe: "off", "summary", "count", "deps" ou "rdeps".
Tags:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
padrão: ".*"-
Filtro regex de nomes do SkyKey para saída. Usado apenas com --skyframe=deps, rdeps.
Tags:bazel_monitoring
- Padrão
--skylark_memory=<a string>
: ver descrição -
Despeja um perfil de memória compatível com pprof para o caminho especificado. Para saber mais, consulte https://github.com/google/pprof.
Tags:bazel_monitoring
- Opções que afetam como o Bazel aplica entradas de build válidas (definições de regra, combinações de sinalizações etc.):
--experimental_repository_hash_file=<a string>
padrão: ""-
Se não estiver vazio, especifica um arquivo que contém um valor resolvido. Os hashes do diretório do repositório precisam ser verificados
Tags:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
usos múltiplos foram acumulados-
Se uma lista de regras de repositório para a qual o hash do diretório de saída precisa ser verificado, desde que um arquivo seja especificado por --experimental_repository_hash_file.
Tags:affects_outputs
,experimental
- Esta opção afeta a semântica da linguagem Starlark ou a API Build acessível a arquivos BUILD, arquivos .bzl ou WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
padrão: "true"-
Tags Op
:no_op
,deprecated
,experimental
- Opções relacionadas à saída e semântica do Bzlmod:
--allow_yanked_versions=<a string>
usos múltiplos foram acumulados-
Especificou as versões do módulo na forma de "<module1>@<version1>,<module2>@<version2>`, que serão permitidas no gráfico de dependências resolvidas, mesmo que sejam declaradas com brincadeira no registro de origem (não provenientes de um NonRegistryOverride). Caso contrário, as versões arrepiadas farão com que a resolução falhe. Também é possível definir a versão permitida com a variável de ambiente `BZLMOD_ALLOW_YANKED_VERSIONS`. Você pode desativar essa verificação usando a palavra-chave "todos" (não recomendado).
Tags:loading_and_analysis