Regras do Java

Regras

java_binary 

java_binary(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_env, deploy_manifest_lines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, javacopts, jvm_flags, launcher, licenses, main_class, output_licenses, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, stamp, tags, target_compatible_with, testonly, toolchains, use_launcher, use_testrunner, visibility)

Cria um arquivo Java ("arquivo jar"), além de um script de shell de wrapper com o mesmo nome da regra. O script de shell do wrapper usa um caminho de classe que inclui, entre outras coisas, um arquivo jar para cada biblioteca de que o binário depende.

O script de wrapper aceita vários sinalizadores exclusivos. Consulte //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt para ver uma lista de sinalizações configuráveis e variáveis de ambiente aceitas pelo wrapper.

Destinos de saída implícitos

  • name.jar: um arquivo Java, contendo os arquivos de classe e outros recursos correspondentes às dependências diretas do binário.
  • name-src.jar: um arquivo que contém as origens ("jar de origem").
  • name_deploy.jar: um arquivo Java adequado para implantação (criado apenas se solicitado explicitamente).

    Criar o destino <name>_deploy.jar para a regra cria um arquivo jar independente com um manifesto que permite que ele seja executado com o comando java -jar ou com a opção --singlejar do script de wrapper. É melhor usar o script de wrapper do que java -jar, porque ele também transmite as sinalizações da JVM e as opções para carregar bibliotecas nativas.

    O jar de implantação contém todas as classes que seriam encontradas por um carregador de classe que pesquisou o caminho de classe no script de wrapper do binário do início ao fim. Ele também contém as bibliotecas nativas necessárias para dependências. Eles são carregados automaticamente na JVM no tempo de execução.

    Se o destino especificar um atributo launcher, em vez de ser um arquivo JAR normal, o _deploy.jar será um binário nativo. Isso conterá a tela de início e todas as dependências nativas (C++) da regra, todas vinculadas a um binário estático. Os bytes do arquivo jar real serão anexados a esse binário nativo, criando um único blob binário contendo o código executável e o código Java. É possível executar o arquivo jar resultante diretamente como você executaria qualquer binário nativo.

  • name_deploy-src.jar: um arquivo que contém as origens coletadas do fechamento transitivo do destino. Eles corresponderão às classes no deploy.jar, exceto quando os jars não tiverem um jar de origem correspondente.

Um atributo deps não é permitido em uma regra java_binary sem srcs. Essa regra exige um main_class fornecido por runtime_deps.

O snippet de código a seguir ilustra um erro comum:

java_binary(
    name = "DontDoThis",
    srcs = [
        ...,
        "GeneratedJavaFile.java",  # a generated .java file
    ],
    deps = [":generating_rule",],  # rule that generates that file
)

Em vez disso, faça o seguinte:

java_binary(
    name = "DoThisInstead",
    srcs = [
        ...,
        ":generating_rule",
    ],
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.


É uma prática recomendada usar o nome do arquivo de origem que é o ponto de entrada principal do aplicativo (menos a extensão). Por exemplo, se o ponto de entrada se chamar Main.java, o nome poderá ser Main.
deps

List of labels; optional

A lista de outras bibliotecas a serem vinculadas ao destino. Consulte comentários gerais sobre deps em Atributos típicos definidos pela maioria das regras de build.
srcs

List of labels; optional

A lista de arquivos de origem que são processados para criar o destino. Esse atributo é quase sempre obrigatório. Veja as exceções abaixo.

Os arquivos de origem do tipo .java são compilados. No caso de arquivos .java gerados, geralmente é aconselhável colocar o nome da regra de geração aqui em vez do nome do próprio arquivo. Isso não apenas melhora a legibilidade, mas torna a regra mais resiliente a alterações futuras. Se a regra de geração gerar arquivos diferentes no futuro, você só precisará corrigir um lugar: o outs da regra de geração. Não liste a regra geradora em deps porque ela é um ambiente autônomo.

Os arquivos de origem do tipo .srcjar são descompactados e compilados. Isso é útil se você precisar gerar um conjunto de arquivos .java com uma regra geral.

Regras: se a regra (normalmente genrule ou filegroup) gerar qualquer um dos arquivos listados acima, eles serão usados da mesma maneira descrita para os arquivos de origem.

Esse argumento quase sempre é obrigatório, exceto se um atributo main_class especificar uma classe no caminho de classe de execução ou se você especificar o argumento runtime_deps.

resources

List of labels; optional

Uma lista de arquivos de dados a serem incluídos em um Java jar.

Se os recursos forem especificados, eles serão agrupados no jar com os arquivos .class comuns produzidos pela compilação. A localização dos recursos dentro do arquivo jar é determinada pela estrutura do projeto. Primeiro, o Bazel procura o layout de diretório padrão do Maven, (um diretório "src" seguido de um neto do diretório "resources"). Se ele não for encontrado, o Bazel vai procurar o diretório superior chamado "java" ou "javatests". Portanto, por exemplo, se um recurso estiver em <workspace root>/x/java/y/java/z, o caminho do recurso será y/java/z. Essa heurística não pode ser substituída. No entanto, o atributo resource_strip_prefix pode ser usado para especificar um diretório alternativo específico para arquivos de recursos.

Os recursos podem ser arquivos de origem ou arquivos gerados.

classpath_resources

List of labels; optional

NÃO USE ESTA OPÇÃO A menos que HÁ DE OUTRA FORMA)

Uma lista de recursos que precisam estar localizados na raiz da árvore Java. A única finalidade desse atributo é oferecer suporte a bibliotecas de terceiros que exigem que os recursos sejam encontrados no caminho de classe como "myconfig.xml". Ele só é permitido em binários, e não em bibliotecas, devido ao perigo de conflitos de namespace.

create_executable

Boolean; optional; nonconfigurable; default is True

Se o binário é executável. Os binários não executáveis coletam dependências Java transitivas do Java em um jar de implantação, mas não podem ser executados diretamente. Nenhum script de wrapper será criado se esse atributo for definido. É um erro definir esse valor como 0 se os atributos launcher ou main_class estiverem definidos.
deploy_env

List of labels; optional

Uma lista de outros destinos java_binary que representam o ambiente de implantação deste binário. Defina esse atributo ao criar um plug-in que será carregado por outro java_binary.
A definição desse atributo exclui todas as dependências do caminho de classe do ambiente de execução (e do jar de implantação) desse binário que são compartilhadas entre esse binário e os destinos especificados em deploy_env.
deploy_manifest_lines

List of strings; optional

Uma lista de linhas a serem adicionadas ao arquivo META-INF/manifest.mf gerado para o destino *_deploy.jar. O conteúdo desse atributo não está sujeito à substituição "Fazer variável".
javacopts

List of strings; optional

Outras opções de compilador para esta biblioteca. Sujeito à substituição "Make variables" e tokenização do shell Bourne.

Essas opções do compilador são transmitidas para javac depois das opções do compilador global
jvm_flags

List of strings; optional

Uma lista de sinalizações a serem incorporadas no script de wrapper gerado para executar esse binário. Sujeito à substituição $(location) e "Make a variável" e a tokenização do shell Bourne.

O script de wrapper de um binário Java inclui uma definição CLASSPATH (para encontrar todos os jars dependentes) e invoca o intérprete Java correto. A linha de comando gerada pelo script de wrapper inclui o nome da classe principal seguido por um "$@" para que você possa transmitir outros argumentos após o nome da classe. No entanto, os argumentos destinados à análise pela JVM precisam ser especificados antes do nome da classe na linha de comando. O conteúdo de jvm_flags é adicionado ao script de wrapper antes que o nome da classe seja listado.

Observe que esse atributo não tem efeito nas saídas de *_deploy.jar.
launcher

Label; optional

Especifique um binário que será usado para executar o programa Java em vez do programa bin/java normal incluído no JDK. O destino precisa ser um cc_binary. Qualquer cc_binary que implemente a API Java Invocation pode ser especificada como um valor para esse atributo.

Por padrão, o Bazel usa o inicializador normal do JDK (bin/java ou java.exe).

A sinalização --java_launcher do Bazel relacionada afeta apenas os destinos java_binary e java_test que não especificaram um atributo launcher.

Observe que suas dependências nativas (C++, SWIG, JNI) serão criadas de maneira diferente se você estiver usando a tela de início do JDK ou outra tela de início:

  • Se você estiver usando a tela de início normal do JDK (padrão), as dependências nativas serão criadas como uma biblioteca compartilhada chamada {name}_nativedeps.so, em que {name} é o atributo name dessa regra java_binary. O código não utilizado não é removido pelo vinculador nesta configuração.
  • Se você estiver usando qualquer outra tela de início, as dependências nativas (C++) serão estaticamente vinculadas a um binário chamado {name}_nativedeps, em que {name} é o atributo name dessa regra java_binary. Nesse caso, o vinculador vai remover qualquer código considerado não utilizado do binário resultante, o que significa que qualquer código C++ acessado somente via JNI pode não ser vinculado, a menos que o destino cc_library especifique alwayslink = 1.

Ao usar qualquer tela de início diferente da tela de início padrão do JDK, o formato da saída *_deploy.jar muda. Consulte a documentação principal de java_binary para ver mais detalhes.
main_class

String; optional

Nome da classe com o método main() a ser usado como ponto de entrada. Se uma regra usar essa opção, ela não precisará de uma lista srcs=[...]. Assim, com esse atributo, é possível tornar um executável de uma biblioteca Java que já contém um ou mais métodos main().

O valor desse atributo é um nome de classe, não um arquivo de origem. A classe precisa estar disponível durante a execução: ela pode ser compilada por essa regra (de srcs) ou fornecida por dependências diretas ou transitivas (por runtime_deps ou deps). Se a classe não estiver disponível, o binário vai falhar no momento da execução. Não há verificação do tempo de build.

plugins

List of labels; optional

Plug-ins do compilador Java para execução em tempo de compilação. Cada java_plugin especificado neste atributo será executado sempre que essa regra for criada. Uma biblioteca também pode herdar plug-ins de dependências que usam exported_plugins. Os recursos gerados pelo plug-in serão incluídos no jar resultante dessa regra.
resource_jars

List of labels; optional

Obsoleto: use java_import e deps ou Runtime_deps.
resource_strip_prefix

String; optional

O prefixo do caminho a ser removido dos recursos Java.

Se especificado, esse prefixo de caminho é removido de todos os arquivos no atributo resources. É um erro se um arquivo de recurso não estiver nesse diretório. Se não for especificado (o padrão), o caminho do arquivo de recursos será determinado de acordo com a mesma lógica do pacote Java de arquivos de origem. Por exemplo, um arquivo de origem em stuff/java/foo/bar/a.txt será localizado em foo/bar/a.txt.

runtime_deps

List of labels; optional

Bibliotecas a serem disponibilizadas para o binário final ou teste apenas no momento da execução. Assim como um deps comum, eles vão aparecer no caminho de classe da execução, mas, ao contrário deles, não no caminho de classe do tempo de compilação. As dependências necessárias apenas no momento da execução precisam ser listadas aqui. As ferramentas de análise de dependência precisam ignorar os destinos que aparecem em runtime_deps e deps.
stamp

Integer; optional; default is -1

Define se as informações de compilação serão codificadas no binário. Valores possíveis:
  • stamp = 1: sempre inclua as informações do build no binário, mesmo em builds --nostamp. Essa configuração precisa ser evitada, porque ela pode eliminar o armazenamento remoto do armazenamento em cache do binário e de quaisquer ações downstream que dependam dele.
  • stamp = 0: sempre substitua as informações do build por valores constantes. Isso fornece um bom armazenamento em cache de resultados do build.
  • stamp = -1: a incorporação de informações de build é controlada pela flag --[no]stamp.

Os binários carimbos não são recriados, a menos que as dependências deles mudem.
use_launcher

Boolean; optional; default is True

Define se o binário precisa usar uma tela de início personalizada.

Se ele for definido como falso, o atributo launcher e a sinalização --java_launcher relacionada serão ignorados para esse destino.

use_testrunner

Boolean; optional; default is False

Use a classe do executor de testes, por padrão, com.google.testing.junit.runner.BazelTestRunner como o ponto de entrada principal de um programa Java e forneça a classe de teste ao executor de testes como um valor da propriedade de sistema bazel.test_suite. Você pode usar isso para substituir o comportamento padrão, que é usar o executor de testes para regras java_test e não para regras java_binary. É improvável que você queira fazer isso. Um uso é para regras AllTest que são invocadas por outra regra (para configurar um banco de dados antes de executar os testes, por exemplo). A regra AllTest precisa ser declarada como java_binary, mas ainda precisa usar o executor de testes como ponto de entrada principal. O nome de uma classe de executor de testes pode ser substituído pelo atributo main_class.

java_import 

java_import(name, deps, data, compatible_with, constraints, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, jars, licenses, neverlink, proguard_specs, restricted_to, runtime_deps, srcjar, tags, target_compatible_with, testonly, visibility)

Essa regra permite o uso de arquivos .jar pré-compilados como bibliotecas para regras java_library e java_binary.

Exemplos

    java_import(
        name = "maven_model",
        jars = [
            "maven_model/maven-aether-provider-3.2.3.jar",
            "maven_model/maven-model-3.2.3.jar",
            "maven_model/maven-model-builder-3.2.3.jar",
        ],
    )

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de outras bibliotecas a serem vinculadas ao destino. Consulte java_library.deps (link em inglês).
constraints

List of strings; optional; nonconfigurable

Restrições extras impostas a essa regra como uma biblioteca Java.
exports

List of labels; optional

Direciona para disponibilizar aos usuários desta regra. Consulte java_library.exports (link em inglês).
jars

List of labels; required

A lista de arquivos JAR fornecidos aos destinos Java que dependem desse destino.

Boolean; optional; default is False

Use essa biblioteca apenas para compilação e não durante a execução. Útil quando a biblioteca for fornecida pelo ambiente de execução durante a execução. Exemplos de bibliotecas como essa são APIs para plug-ins desse ambiente ou tools.jar para qualquer item executado em um JDK padrão.
proguard_specs

List of labels; optional

Arquivos a serem usados como especificação do Proguard. Eles descrevem o conjunto de especificações a serem usadas pelo Proguard. Se especificado, eles serão adicionados a qualquer destino android_binary, dependendo dessa biblioteca. Os arquivos incluídos aqui precisam ter apenas regras idempotentes, como -dontnote, -dontwarn, suposições de efeitos colaterais e regras que começam com -keep. Outras opções só podem aparecer nas proguard_specs de android_binary para garantir mesclagens não automáticas.
runtime_deps

List of labels; optional

Bibliotecas a serem disponibilizadas para o binário final ou teste apenas no momento da execução. Consulte java_library.runtime_deps (link em inglês).
srcjar

Label; optional

Um arquivo JAR que contém o código-fonte dos arquivos JAR compilados.

java_library 

java_library(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exported_plugins, exports, features, javacopts, licenses, neverlink, plugins, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, tags, target_compatible_with, testonly, visibility)

Esta regra compila e vincula as fontes a um arquivo .jar.

Destinos de saída implícitos

  • libname.jar: um arquivo Java que contém os arquivos de classe.
  • libname-src.jar: um arquivo que contém as origens ("jar de origem").

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de bibliotecas que serão vinculadas a esta biblioteca. Consulte comentários gerais sobre deps em Atributos típicos definidos pela maioria das regras de build.

Os jars criados pelas regras java_library listadas em deps estarão no caminho de classe do tempo de compilação dessa regra. Além disso, o fechamento transitivo dos deps, runtime_deps e exports vai estar no caminho de classe de execução.

Por outro lado, os destinos no atributo data são incluídos nos arquivos de execução, mas não no caminho de classe do tempo de compilação nem do ambiente de execução.

srcs

List of labels; optional

A lista de arquivos de origem que são processados para criar o destino. Esse atributo é quase sempre obrigatório. Veja as exceções abaixo.

Os arquivos de origem do tipo .java são compilados. No caso de arquivos .java gerados, geralmente é aconselhável colocar o nome da regra de geração aqui em vez do nome do próprio arquivo. Isso não apenas melhora a legibilidade, mas torna a regra mais resiliente a alterações futuras. Se a regra de geração gerar arquivos diferentes no futuro, você só precisará corrigir um lugar: o outs da regra de geração. Não liste a regra geradora em deps porque ela é um ambiente autônomo.

Os arquivos de origem do tipo .srcjar são descompactados e compilados. Isso é útil se você precisar gerar um conjunto de arquivos .java com uma regra geral.

Regras: se a regra (normalmente genrule ou filegroup) gerar qualquer um dos arquivos listados acima, eles serão usados da mesma maneira descrita para os arquivos de origem.

Esse argumento quase sempre é obrigatório, exceto se um atributo main_class especificar uma classe no caminho de classe de execução ou se você especificar o argumento runtime_deps.

data

List of labels; optional

Lista de arquivos necessários para essa biblioteca no momento da execução. Consulte comentários gerais sobre data em Atributos típicos definidos pela maioria das regras de build.

Ao criar um java_library, o Bazel não coloca esses arquivos em nenhum lugar. Se os arquivos data forem gerados, eles serão gerados pelo Bazel. Ao criar um teste que depende desse java_library, o Bazel copia ou vincula os arquivos data para a área de arquivos de execução.

resources

List of labels; optional

Uma lista de arquivos de dados a serem incluídos em um Java jar.

Se os recursos forem especificados, eles serão agrupados no jar com os arquivos .class comuns produzidos pela compilação. A localização dos recursos dentro do arquivo jar é determinada pela estrutura do projeto. Primeiro, o Bazel procura o layout de diretório padrão do Maven, (um diretório "src" seguido de um neto do diretório "resources"). Se ele não for encontrado, o Bazel vai procurar o diretório superior chamado "java" ou "javatests". Portanto, por exemplo, se um recurso estiver em <workspace root>/x/java/y/java/z, o caminho do recurso será y/java/z. Essa heurística não pode ser substituída. No entanto, o atributo resource_strip_prefix pode ser usado para especificar um diretório alternativo específico para arquivos de recursos.

Os recursos podem ser arquivos de origem ou arquivos gerados.

exported_plugins

List of labels; optional

A lista de java_plugins (por exemplo, processadores de anotações) a serem exportados para bibliotecas que dependem diretamente dessa biblioteca.

A lista especificada de java_plugins será aplicada a qualquer biblioteca que dependa diretamente dessa biblioteca, como se ela tivesse declarado explicitamente esses rótulos em plugins.

exports

List of labels; optional

Bibliotecas exportadas.

Listar regras aqui as disponibilizará para as regras pai, como se os pais dependessem explicitamente dessas regras. Isso não é verdade para deps normais (não exportadas).

Resumo: uma regra X pode acessar o código em Y se houver um caminho de dependência entre elas que comece com uma borda deps seguida por zero ou mais bordas exports. Vamos ver alguns exemplos para ilustrar isso.

Suponha que A dependa de B e B dependa de C. Nesse caso, C é uma dependência transitiva de A. Portanto, mudar as origens de C e recriar A recriará tudo corretamente. No entanto, A não poderá usar classes em C. Para permitir isso, A precisa declarar C no deps, ou B pode facilitar para A (e qualquer coisa que dependa de A) declarando C no atributo exports (B de).

O fechamento de bibliotecas exportadas está disponível para todas as regras de pai direto. Veja um exemplo um pouco diferente: A depende de B, B depende de C e D e também exporta C, mas não D. Agora A tem acesso a C, mas não a D. Agora, se C e D exportassem algumas bibliotecas, C' e D', respectivamente, A só poderia acessar C', mas não D'.

Importante: uma regra exportada não é uma dependência normal. No exemplo anterior, se B exportar C e também quiser usar C, também será necessário listá-lo no próprio deps.

javacopts

List of strings; optional

Outras opções de compilador para esta biblioteca. Sujeito à substituição "Make variables" e tokenização do shell Bourne.

Essas opções do compilador são transmitidas para javac depois das opções do compilador global

Boolean; optional; default is False

Define se essa biblioteca só precisa ser usada para compilação e não no momento da execução. Útil se a biblioteca for fornecida pelo ambiente de execução durante a execução. Exemplos dessas bibliotecas são as APIs IDE para plug-ins do ambiente de desenvolvimento integrado ou tools.jar para qualquer item em execução em um JDK padrão.

Observe que neverlink = 1 não impede que o compilador incorpore o material dessa biblioteca em linha em destinos de compilação que dependam dele, conforme permitido pela especificação da linguagem Java (por exemplo, constantes static final de String ou de tipos primitivos). O caso de uso recomendado é, portanto, quando a biblioteca de tempo de execução é idêntica à biblioteca de compilação.

Se a biblioteca de tempo de execução for diferente da biblioteca de compilação, é necessário garantir que ela diferencie apenas em locais em que o JLS proíbe compiladores em linha (e que precisam manter todas as versões futuras do JLS).

plugins

List of labels; optional

Plug-ins do compilador Java para execução em tempo de compilação. Cada java_plugin especificado neste atributo será executado sempre que essa regra for criada. Uma biblioteca também pode herdar plug-ins de dependências que usam exported_plugins. Os recursos gerados pelo plug-in serão incluídos no jar resultante dessa regra.
proguard_specs

List of labels; optional

Arquivos a serem usados como especificação do Proguard. Eles descrevem o conjunto de especificações a serem usadas pelo Proguard. Se especificado, eles serão adicionados a qualquer destino android_binary, dependendo dessa biblioteca. Os arquivos incluídos aqui precisam ter apenas regras idempotentes, como -dontnote, -dontwarn, suposições de efeitos colaterais e regras que começam com -keep. Outras opções só podem aparecer nas proguard_specs de android_binary para garantir mesclagens não automáticas.
resource_jars

List of labels; optional

Obsoleto: use java_import e deps ou Runtime_deps.
resource_strip_prefix

String; optional

O prefixo do caminho a ser removido dos recursos Java.

Se especificado, esse prefixo de caminho é removido de todos os arquivos no atributo resources. É um erro se um arquivo de recurso não estiver nesse diretório. Se não for especificado (o padrão), o caminho do arquivo de recursos será determinado de acordo com a mesma lógica do pacote Java de arquivos de origem. Por exemplo, um arquivo de origem em stuff/java/foo/bar/a.txt será localizado em foo/bar/a.txt.

runtime_deps

List of labels; optional

Bibliotecas a serem disponibilizadas para o binário final ou teste apenas no momento da execução. Assim como um deps comum, eles vão aparecer no caminho de classe da execução, mas, ao contrário deles, não no caminho de classe do tempo de compilação. As dependências necessárias apenas no momento da execução precisam ser listadas aqui. As ferramentas de análise de dependência precisam ignorar os destinos que aparecem em runtime_deps e deps.

java_lite_proto_library 

java_lite_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

java_lite_proto_library gera código Java a partir de arquivos .proto.

deps precisa apontar para regras proto_library .

Exemplos 

java_library(
    name = "lib",
    deps = [":foo"],
)

java_lite_proto_library(
    name = "foo",
    deps = [":bar"],
)

proto_library(
    name = "bar",
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de regras proto_library para as quais gerar o código Java.

java_proto_library 

java_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

java_proto_library gera código Java a partir de arquivos .proto.

deps precisa apontar para regras proto_library .

Exemplos 

java_library(
    name = "lib",
    deps = [":foo_java_proto"],
)

java_proto_library(
    name = "foo_java_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de regras proto_library para as quais gerar o código Java.

java_test 

java_test(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_manifest_lines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, launcher, licenses, local, main_class, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, use_testrunner, visibility)

Uma regra java_test() compila um teste Java. Um teste é um wrapper binário em torno do seu código de teste. O método principal do executor de testes é invocado em vez de a classe principal que está sendo compilada.

Destinos de saída implícitos

  • name.jar: um arquivo Java.
  • name_deploy.jar: um arquivo Java adequado para implantação. Criada somente se solicitado explicitamente. Consulte a descrição da saída name_deploy.jar de java_binary para saber mais.

Consulte a seção sobre argumentos java_binary(). Essa regra também oferece suporte a todos os atributos comuns a todas as regras de teste (*_test).

Exemplos

java_library(
    name = "tests",
    srcs = glob(["*.java"]),
    deps = [
        "//java/com/foo/base:testResources",
        "//java/com/foo/testing/util",
    ],
)

java_test(
    name = "AllTests",
    size = "small",
    runtime_deps = [
        ":tests",
        "//util/mysql",
    ],
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de outras bibliotecas a serem vinculadas ao destino. Consulte comentários gerais sobre deps em Atributos típicos definidos pela maioria das regras de build.
srcs

List of labels; optional

A lista de arquivos de origem que são processados para criar o destino. Esse atributo é quase sempre obrigatório. Veja as exceções abaixo.

Os arquivos de origem do tipo .java são compilados. No caso de arquivos .java gerados, geralmente é aconselhável colocar o nome da regra de geração aqui em vez do nome do próprio arquivo. Isso não apenas melhora a legibilidade, mas torna a regra mais resiliente a alterações futuras. Se a regra de geração gerar arquivos diferentes no futuro, você só precisará corrigir um lugar: o outs da regra de geração. Não liste a regra geradora em deps porque ela é um ambiente autônomo.

Os arquivos de origem do tipo .srcjar são descompactados e compilados. Isso é útil se você precisar gerar um conjunto de arquivos .java com uma regra geral.

Regras: se a regra (normalmente genrule ou filegroup) gerar qualquer um dos arquivos listados acima, eles serão usados da mesma maneira descrita para os arquivos de origem.

Esse argumento quase sempre é obrigatório, exceto se um atributo main_class especificar uma classe no caminho de classe de execução ou se você especificar o argumento runtime_deps.

resources

List of labels; optional

Uma lista de arquivos de dados a serem incluídos em um Java jar.

Se os recursos forem especificados, eles serão agrupados no jar com os arquivos .class comuns produzidos pela compilação. A localização dos recursos dentro do arquivo jar é determinada pela estrutura do projeto. Primeiro, o Bazel procura o layout de diretório padrão do Maven, (um diretório "src" seguido de um neto do diretório "resources"). Se ele não for encontrado, o Bazel vai procurar o diretório superior chamado "java" ou "javatests". Portanto, por exemplo, se um recurso estiver em <workspace root>/x/java/y/java/z, o caminho do recurso será y/java/z. Essa heurística não pode ser substituída. No entanto, o atributo resource_strip_prefix pode ser usado para especificar um diretório alternativo específico para arquivos de recursos.

Os recursos podem ser arquivos de origem ou arquivos gerados.

classpath_resources

List of labels; optional

NÃO USE ESTA OPÇÃO A menos que HÁ DE OUTRA FORMA)

Uma lista de recursos que precisam estar localizados na raiz da árvore Java. A única finalidade desse atributo é oferecer suporte a bibliotecas de terceiros que exigem que os recursos sejam encontrados no caminho de classe como "myconfig.xml". Ele só é permitido em binários, e não em bibliotecas, devido ao perigo de conflitos de namespace.

create_executable

Boolean; optional; nonconfigurable; default is True

Se o binário é executável. Os binários não executáveis coletam dependências Java transitivas do Java em um jar de implantação, mas não podem ser executados diretamente. Nenhum script de wrapper será criado se esse atributo for definido. É um erro definir esse valor como 0 se os atributos launcher ou main_class estiverem definidos.
deploy_manifest_lines

List of strings; optional

Uma lista de linhas a serem adicionadas ao arquivo META-INF/manifest.mf gerado para o destino *_deploy.jar. O conteúdo desse atributo não está sujeito à substituição "Fazer variável".
javacopts

List of strings; optional

Outras opções de compilador para esta biblioteca. Sujeito à substituição "Make variables" e tokenização do shell Bourne.

Essas opções do compilador são transmitidas para javac depois das opções do compilador global
jvm_flags

List of strings; optional

Uma lista de sinalizações a serem incorporadas no script de wrapper gerado para executar esse binário. Sujeito à substituição $(location) e "Make a variável" e a tokenização do shell Bourne.

O script de wrapper de um binário Java inclui uma definição CLASSPATH (para encontrar todos os jars dependentes) e invoca o intérprete Java correto. A linha de comando gerada pelo script de wrapper inclui o nome da classe principal seguido por um "$@" para que você possa transmitir outros argumentos após o nome da classe. No entanto, os argumentos destinados à análise pela JVM precisam ser especificados antes do nome da classe na linha de comando. O conteúdo de jvm_flags é adicionado ao script de wrapper antes que o nome da classe seja listado.

Observe que esse atributo não tem efeito nas saídas de *_deploy.jar.
launcher

Label; optional

Especifique um binário que será usado para executar o programa Java em vez do programa bin/java normal incluído no JDK. O destino precisa ser um cc_binary. Qualquer cc_binary que implemente a API Java Invocation pode ser especificada como um valor para esse atributo.

Por padrão, o Bazel usa o inicializador normal do JDK (bin/java ou java.exe).

A sinalização --java_launcher do Bazel relacionada afeta apenas os destinos java_binary e java_test que não especificaram um atributo launcher.

Observe que suas dependências nativas (C++, SWIG, JNI) serão criadas de maneira diferente se você estiver usando a tela de início do JDK ou outra tela de início:

  • Se você estiver usando a tela de início normal do JDK (padrão), as dependências nativas serão criadas como uma biblioteca compartilhada chamada {name}_nativedeps.so, em que {name} é o atributo name dessa regra java_binary. O código não utilizado não é removido pelo vinculador nesta configuração.
  • Se você estiver usando qualquer outra tela de início, as dependências nativas (C++) serão estaticamente vinculadas a um binário chamado {name}_nativedeps, em que {name} é o atributo name dessa regra java_binary. Nesse caso, o vinculador vai remover qualquer código considerado não utilizado do binário resultante, o que significa que qualquer código C++ acessado somente via JNI pode não ser vinculado, a menos que o destino cc_library especifique alwayslink = 1.

Ao usar qualquer tela de início diferente da tela de início padrão do JDK, o formato da saída *_deploy.jar muda. Consulte a documentação principal de java_binary para ver mais detalhes.
main_class

String; optional

Nome da classe com o método main() a ser usado como ponto de entrada. Se uma regra usar essa opção, ela não precisará de uma lista srcs=[...]. Assim, com esse atributo, é possível tornar um executável de uma biblioteca Java que já contém um ou mais métodos main().

O valor desse atributo é um nome de classe, não um arquivo de origem. A classe precisa estar disponível durante a execução: ela pode ser compilada por essa regra (de srcs) ou fornecida por dependências diretas ou transitivas (por runtime_deps ou deps). Se a classe não estiver disponível, o binário vai falhar no momento da execução. Não há verificação do tempo de build.

plugins

List of labels; optional

Plug-ins do compilador Java para execução em tempo de compilação. Cada java_plugin especificado neste atributo será executado sempre que essa regra for criada. Uma biblioteca também pode herdar plug-ins de dependências que usam exported_plugins. Os recursos gerados pelo plug-in serão incluídos no jar resultante dessa regra.
resource_jars

List of labels; optional

Obsoleto: use java_import e deps ou Runtime_deps.
resource_strip_prefix

String; optional

O prefixo do caminho a ser removido dos recursos Java.

Se especificado, esse prefixo de caminho é removido de todos os arquivos no atributo resources. É um erro se um arquivo de recurso não estiver nesse diretório. Se não for especificado (o padrão), o caminho do arquivo de recursos será determinado de acordo com a mesma lógica do pacote Java de arquivos de origem. Por exemplo, um arquivo de origem em stuff/java/foo/bar/a.txt será localizado em foo/bar/a.txt.

runtime_deps

List of labels; optional

Bibliotecas a serem disponibilizadas para o binário final ou teste apenas no momento da execução. Assim como um deps comum, eles vão aparecer no caminho de classe da execução, mas, ao contrário deles, não no caminho de classe do tempo de compilação. As dependências necessárias apenas no momento da execução precisam ser listadas aqui. As ferramentas de análise de dependência precisam ignorar os destinos que aparecem em runtime_deps e deps.
stamp

Integer; optional; default is 0

Define se as informações de compilação serão codificadas no binário. Valores possíveis:
  • stamp = 1: sempre inclua as informações do build no binário, mesmo em builds --nostamp. Essa configuração precisa ser evitada, porque ela pode eliminar o armazenamento remoto do armazenamento em cache do binário e de quaisquer ações downstream que dependam dele.
  • stamp = 0: sempre substitua as informações do build por valores constantes. Isso fornece um bom armazenamento em cache de resultados do build.
  • stamp = -1: a incorporação de informações de build é controlada pela flag --[no]stamp.

Os binários carimbos não são recriados, a menos que as dependências deles mudem.
test_class

String; optional

A classe Java a ser carregada pelo executor de teste.

Por padrão, se esse argumento não for definido, o modo legado será usado e os argumentos de teste serão utilizados. Defina a sinalização --nolegacy_bazel_java_test para não substituir o primeiro argumento.

Este atributo especifica o nome de uma classe Java a ser executada por este teste. É raro configurar isso. Se for omitido, o argumento será inferido usando o name do destino e o caminho relativo à raiz da origem. Se o teste estiver localizado fora de uma raiz de origem conhecida, o Bazel informará um erro se test_class não estiver definido.

Para JUnit3, a classe de teste precisa ser uma subclasse de junit.framework.TestCase ou ter um método suite() estático público que retorne um junit.framework.Test (ou uma subclasse de Test). Para JUnit4, a classe precisa ser anotada com org.junit.runner.RunWith.

Esse atributo permite que várias regras java_test compartilhem o mesmo Test (TestCase, TestSuite, ...). Normalmente, outras informações são transmitidas a ele (por exemplo, via jvm_flags=['-Dkey=value']) para que o comportamento seja diferente em cada caso, como a execução de um subconjunto diferente dos testes. Esse atributo também permite o uso de testes Java fora da árvore javatests.

use_launcher

Boolean; optional; default is True

Define se o binário precisa usar uma tela de início personalizada.

Se ele for definido como falso, o atributo launcher e a sinalização --java_launcher relacionada serão ignorados para esse destino.

use_testrunner

Boolean; optional; default is True

Use a classe do executor de testes, por padrão, com.google.testing.junit.runner.BazelTestRunner como o ponto de entrada principal de um programa Java e forneça a classe de teste ao executor de testes como um valor da propriedade de sistema bazel.test_suite. Você pode usar isso para substituir o comportamento padrão, que é usar o executor de testes para regras java_test e não para regras java_binary. É improvável que você queira fazer isso. Um uso é para regras AllTest que são invocadas por outra regra (para configurar um banco de dados antes de executar os testes, por exemplo). A regra AllTest precisa ser declarada como java_binary, mas ainda precisa usar o executor de testes como ponto de entrada principal. O nome de uma classe de executor de testes pode ser substituído pelo atributo main_class.

java_package_configuration 

java_package_configuration(name, data, compatible_with, deprecation, distribs, features, javacopts, licenses, packages, restricted_to, tags, target_compatible_with, testonly, visibility)

Configuração a ser aplicada a um conjunto de pacotes. As configurações podem ser adicionadas a java_toolchain.javacoptss.

Exemplos

java_package_configuration(
    name = "my_configuration",
    packages = [":my_packages"],
    javacopts = ["-Werror"],
)

package_group(
    name = "my_packages",
    packages = [
        "//com/my/project/...",
        "-//com/my/project/testing/...",
    ],
)

java_toolchain(
    ...,
    package_configuration = [
        ":my_configuration",
    ]
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
data

List of labels; optional

Lista de arquivos necessários para essa configuração no ambiente de execução.
javacopts

List of strings; optional

Sinalizações do compilador Java.
packages

List of labels; optional

O conjunto de package_groups em que a configuração será aplicada.

java_plugin 

java_plugin(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, generates_api, javacopts, licenses, neverlink, output_licenses, plugins, processor_class, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, tags, target_compatible_with, testonly, visibility)

java_plugin define plug-ins para o compilador Java executado pelo Bazel. No momento, o único tipo de plug-in compatível são processadores de anotações. Uma regra java_library ou java_binary pode executar plug-ins dependendo deles por meio do atributo plugins. Um java_library também pode exportar automaticamente plug-ins para bibliotecas que dependem diretamente dele usando exported_plugins.

Destinos de saída implícitos

  • libname.jar: um arquivo Java.

Os argumentos são idênticos a java_library, exceto pela adição do argumento processor_class.

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
deps

List of labels; optional

A lista de bibliotecas que serão vinculadas a esta biblioteca. Consulte comentários gerais sobre deps em Atributos típicos definidos pela maioria das regras de build.

Os jars criados pelas regras java_library listadas em deps estarão no caminho de classe do tempo de compilação dessa regra. Além disso, o fechamento transitivo dos deps, runtime_deps e exports vai estar no caminho de classe de execução.

Por outro lado, os destinos no atributo data são incluídos nos arquivos de execução, mas não no caminho de classe do tempo de compilação nem do ambiente de execução.

srcs

List of labels; optional

A lista de arquivos de origem que são processados para criar o destino. Esse atributo é quase sempre obrigatório. Veja as exceções abaixo.

Os arquivos de origem do tipo .java são compilados. No caso de arquivos .java gerados, geralmente é aconselhável colocar o nome da regra de geração aqui em vez do nome do próprio arquivo. Isso não apenas melhora a legibilidade, mas torna a regra mais resiliente a alterações futuras. Se a regra de geração gerar arquivos diferentes no futuro, você só precisará corrigir um lugar: o outs da regra de geração. Não liste a regra geradora em deps porque ela é um ambiente autônomo.

Os arquivos de origem do tipo .srcjar são descompactados e compilados. Isso é útil se você precisar gerar um conjunto de arquivos .java com uma regra geral.

Regras: se a regra (normalmente genrule ou filegroup) gerar qualquer um dos arquivos listados acima, eles serão usados da mesma maneira descrita para os arquivos de origem.

Esse argumento quase sempre é obrigatório, exceto se um atributo main_class especificar uma classe no caminho de classe de execução ou se você especificar o argumento runtime_deps.

data

List of labels; optional

Lista de arquivos necessários para essa biblioteca no momento da execução. Consulte comentários gerais sobre data em Atributos típicos definidos pela maioria das regras de build.

Ao criar um java_library, o Bazel não coloca esses arquivos em nenhum lugar. Se os arquivos data forem gerados, eles serão gerados pelo Bazel. Ao criar um teste que depende desse java_library, o Bazel copia ou vincula os arquivos data para a área de arquivos de execução.

resources

List of labels; optional

Uma lista de arquivos de dados a serem incluídos em um Java jar.

Se os recursos forem especificados, eles serão agrupados no jar com os arquivos .class comuns produzidos pela compilação. A localização dos recursos dentro do arquivo jar é determinada pela estrutura do projeto. Primeiro, o Bazel procura o layout de diretório padrão do Maven, (um diretório "src" seguido de um neto do diretório "resources"). Se ele não for encontrado, o Bazel vai procurar o diretório superior chamado "java" ou "javatests". Portanto, por exemplo, se um recurso estiver em <workspace root>/x/java/y/java/z, o caminho do recurso será y/java/z. Essa heurística não pode ser substituída. No entanto, o atributo resource_strip_prefix pode ser usado para especificar um diretório alternativo específico para arquivos de recursos.

Os recursos podem ser arquivos de origem ou arquivos gerados.

generates_api

Boolean; optional; default is False

Esse atributo marca os processadores de anotações que geram o código da API.

Se uma regra usar um processador de anotações que gera uma API, outras regras dependentes poderão se referir ao código gerado somente se as ações de compilação forem programadas após a regra de geração. Este atributo instrui o Bazel a introduzir restrições de programação quando --java_header_compilation estiver ativado.

AVISO: esse atributo afeta o desempenho do build. Use-o apenas se necessário.
javacopts

List of strings; optional

Outras opções de compilador para esta biblioteca. Sujeito à substituição "Make variables" e tokenização do shell Bourne.

Essas opções do compilador são transmitidas para javac depois das opções do compilador global

Boolean; optional; default is False

Define se essa biblioteca só precisa ser usada para compilação e não no momento da execução. Útil se a biblioteca for fornecida pelo ambiente de execução durante a execução. Exemplos dessas bibliotecas são as APIs IDE para plug-ins do ambiente de desenvolvimento integrado ou tools.jar para qualquer item em execução em um JDK padrão.

Observe que neverlink = 1 não impede que o compilador incorpore o material dessa biblioteca em linha em destinos de compilação que dependam dele, conforme permitido pela especificação da linguagem Java (por exemplo, constantes static final de String ou de tipos primitivos). O caso de uso recomendado é, portanto, quando a biblioteca de tempo de execução é idêntica à biblioteca de compilação.

Se a biblioteca de tempo de execução for diferente da biblioteca de compilação, é necessário garantir que ela diferencie apenas em locais em que o JLS proíbe compiladores em linha (e que precisam manter todas as versões futuras do JLS).

output_licenses

Licence type; optional

Consulte common attributes .
plugins

List of labels; optional

Plug-ins do compilador Java para execução em tempo de compilação. Cada java_plugin especificado neste atributo será executado sempre que essa regra for criada. Uma biblioteca também pode herdar plug-ins de dependências que usam exported_plugins. Os recursos gerados pelo plug-in serão incluídos no jar resultante dessa regra.
processor_class

String; optional

A classe de processador é o tipo totalmente qualificado da classe que o compilador Java precisa usar como ponto de entrada para o processador de anotações. Se não for especificada, essa regra não contribuirá com o processamento de anotações do compilador Java, mas o caminho de classe do tempo de execução ainda será incluído no caminho do processador de anotações do compilador. Isso se destina principalmente ao uso por plug-ins propensos a erros, que são carregados pelo caminho do processador de anotações usando java.util.ServiceLoader.
proguard_specs

List of labels; optional

Arquivos a serem usados como especificação do Proguard. Eles descrevem o conjunto de especificações a serem usadas pelo Proguard. Se especificado, eles serão adicionados a qualquer destino android_binary, dependendo dessa biblioteca. Os arquivos incluídos aqui precisam ter apenas regras idempotentes, como -dontnote, -dontwarn, suposições de efeitos colaterais e regras que começam com -keep. Outras opções só podem aparecer nas proguard_specs de android_binary para garantir mesclagens não automáticas.
resource_jars

List of labels; optional

Obsoleto: use java_import e deps ou Runtime_deps.
resource_strip_prefix

String; optional

O prefixo do caminho a ser removido dos recursos Java.

Se especificado, esse prefixo de caminho é removido de todos os arquivos no atributo resources. É um erro se um arquivo de recurso não estiver nesse diretório. Se não for especificado (o padrão), o caminho do arquivo de recursos será determinado de acordo com a mesma lógica do pacote Java de arquivos de origem. Por exemplo, um arquivo de origem em stuff/java/foo/bar/a.txt será localizado em foo/bar/a.txt.

java_runtime 

java_runtime(name, srcs, compatible_with, deprecation, distribs, features, hermetic_srcs, java, java_home, lib_modules, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

Especifica a configuração de um ambiente de execução do Java.

Exemplos

java_runtime(
    name = "jdk-9-ea+153",
    srcs = glob(["jdk9-ea+153/**"]),
    java_home = "jdk9-ea+153",
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
srcs

List of labels; optional

Todos os arquivos no ambiente de execução.
hermetic_srcs

List of labels; optional

Arquivos no ambiente de execução necessários para implantações herméticas.
java

Label; optional

O caminho para o executável Java.
java_home

String; optional

O caminho para a raiz do ambiente de execução. Sujeito à substituição de variável"Make". Se esse caminho for absoluto, a regra vai indicar um ambiente de execução Java não hermético com um caminho conhecido. Nesse caso, os atributos srcs e java precisam estar vazios.
lib_modules

Label; optional

O arquivo lib/modules necessário para implantações herméticas.

java_toolchain 

java_toolchain(name, android_lint_data, android_lint_jvm_opts, android_lint_opts, android_lint_package_configuration, android_lint_runner, bootclasspath, compatible_with, deprecation, deps_checker, distribs, features, forcibly_disable_header_compilation, genclass, header_compiler, header_compiler_direct, ijar, jacocorunner, java_runtime, javabuilder, javabuilder_data, javabuilder_jvm_opts, javac_supports_multiplex_workers, javac_supports_workers, javacopts, jvm_opts, licenses, oneversion, oneversion_whitelist, package_configuration, proguard_allowlister, resourcejar, restricted_to, singlejar, source_version, tags, target_compatible_with, target_version, testonly, timezone_data, tools, turbine_data, turbine_jvm_opts, visibility, xlint)

Especifica a configuração do compilador Java. O conjunto de ferramentas a ser usado pode ser alterado por meio do argumento --java_dataset. Normalmente, você não deve escrever esse tipo de regra, a menos que queira ajustar seu compilador Java.

Exemplos

Um exemplo simples seria: 

java_toolchain(
    name = "toolchain",
    source_version = "7",
    target_version = "7",
    bootclasspath = ["//tools/jdk:bootclasspath"],
    xlint = [ "classfile", "divzero", "empty", "options", "path" ],
    javacopts = [ "-g" ],
    javabuilder = ":JavaBuilder_deploy.jar",
)

Argumentos

Atributos
name

Name; required

Um nome exclusivo para o destino.
android_lint_data

List of labels; optional

Rótulos das ferramentas disponíveis para expansão de rótulos em android_lint_jvm_opts.
android_lint_jvm_opts

List of strings; optional

Lista de argumentos para a JVM ao invocar o Android Lint.
android_lint_opts

List of strings; optional

Lista de argumentos do Android Lint.
android_lint_package_configuration

List of labels; optional

Configuração do Android Lint que deve ser aplicada aos grupos de pacotes especificados.
android_lint_runner

Label; optional

Identificador do executor do Android Lint, se houver.
bootclasspath

List of labels; optional

As entradas bootclasspath de destino do Java. Corresponde à sinalização -bootclasspath do javac.
deps_checker

List of labels; optional

Rótulo do jar de implantação do ImportDepsChecker.
forcibly_disable_header_compilation

Boolean; optional; default is False

Substitui --java_header_compilation para desativar a compilação de cabeçalhos em plataformas que não oferecem suporte a ela, por exemplo, JDK 7 Bazel.
genclass

List of labels; required

Rótulo do jar de implantação da GenClass.
header_compiler

List of labels; optional

Rótulo do compilador do cabeçalho. Obrigatório se --java_header_compilation estiver ativado.
header_compiler_direct

List of labels; optional

Rótulo opcional do compilador de cabeçalho a ser usado para ações diretas de caminho de classe que não incluem processadores de anotações que geram APIs.

Esta ferramenta não é compatível com o processamento de anotações.

ijar

List of labels; required

Rótulo do executável ijar.
jacocorunner

Label; optional

Identificador do jar de implantação do JacocoCoverageRunner.
java_runtime

Label; required

O java_runtime a ser usado com esse conjunto de ferramentas. O padrão é java_runtime na configuração de execução.
javabuilder

List of labels; required

Rótulo do jar de implantação do JavaBuilder.
javabuilder_data

List of labels; optional

Rótulos de dados disponíveis para expansão de rótulo em javabuilder_jvm_opts.
javabuilder_jvm_opts

List of strings; optional

A lista de argumentos para a JVM ao invocar o JavaBuilder.
javac_supports_multiplex_workers

Boolean; optional; default is True

Verdadeiro se o JavaBuilder oferece suporte à execução como um worker persistente multiplex, e falso se não for.
javac_supports_workers

Boolean; optional; default is True

Verdadeiro se o JavaBuilder oferece suporte à execução como um worker persistente, falso se ela não for compatível.
javacopts

List of strings; optional

A lista de argumentos extras do compilador Java. Consulte a documentação do compilador Java para ver a lista completa de possíveis flags do compilador Java.
jvm_opts

List of strings; optional

A lista de argumentos para a JVM ao invocar o compilador Java. Consulte a documentação da máquina virtual Java para ver a lista extensa de possíveis sinalizações para essa opção.
oneversion

Label; optional

Identificador do binário de aplicação de uma versão.
oneversion_whitelist

Label; optional

Marcador da lista de permissões de uma versão.
package_configuration

List of labels; optional

Configuração que precisa ser aplicada aos grupos de pacotes especificados.
proguard_allowlister

Label; optional; default is @bazel_tools//tools/jdk:proguard_whitelister

Marcador da lista de permissões do Proguard.
resourcejar

List of labels; optional

Rótulo do executável do builder de jar de recurso.
singlejar

List of labels; required

Rótulo do jar de implantação do SingleJar.
source_version

String; optional

A versão de origem Java (por exemplo, "6" ou "7"). Ele especifica quais conjuntos de estruturas de código são permitidos no código-fonte Java.
target_version

String; optional

A versão de destino do Java (por exemplo, "6" ou "7"). Ele especifica para qual ambiente de execução do Java a classe precisa ser criada.
timezone_data

Label; optional

Rótulo de um jar de recursos que contém dados de fuso horário. Se definido, os dados de fuso horário serão adicionados como uma dependência implícita de tempo de execução de todas as regras java_binary.
tools

List of labels; optional

Rótulos das ferramentas disponíveis para a expansão dos rótulos em jvm_opts.
turbine_data

List of labels; optional

Rótulos de dados disponíveis para expansão de rótulos em turbine_jvm_opts.
turbine_jvm_opts

List of strings; optional

A lista de argumentos para a JVM ao invocar a turbina.
xlint

List of strings; optional

A lista de avisos a serem adicionados ou removidos da lista padrão. A remoção é precedida por um traço. Consulte a documentação do Javac sobre as opções do -Xlint para mais informações.