Reglas
- java_binary
- java_import
- java_library
- java_lite_proto_library
- java_proto_library
- java_test
- java_package_configuration
- java_plugin
- java_runtime
- java_toolchain
java_binary
Ver la fuente de la reglajava_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)
Compila un archivo Java ("archivo jar"), además de una secuencia de comandos de shell de wrapper con el mismo nombre que la regla.
La secuencia de comandos de shell del wrapper usa una ruta de clase que incluye, entre otras cosas, un archivo jar para cada biblioteca de la que depende el objeto binario. Cuando se ejecuta la secuencia de comandos de shell del wrapper, cualquier variable de entorno JAVABIN
que no esté vacía tendrá prioridad sobre la versión especificada a través de la marca --java_runtime_version
de Bazel.
La secuencia de comandos del wrapper acepta varias marcas únicas. Consulta //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt
para obtener una lista de marcas configurables y variables de entorno que acepta el wrapper.
Destinos de salida implícitos
name.jar
: Es un archivo Java que contiene los archivos de clase y otros recursos que corresponden a las dependencias directas del binario.name-src.jar
: Es un archivo que contiene las fuentes ("jar de origen").name_deploy.jar
: Es un archivo Java adecuado para la implementación (solo se compila si se solicita de manera explícita).Si compilas el destino
<name>_deploy.jar
de tu regla, se creará un archivo jar autónomo con un manifiesto que permite que se ejecute con el comandojava -jar
o con la opción--singlejar
de la secuencia de comandos del wrapper. Se prefiere el uso de la secuencia de comandos del wrapper antes quejava -jar
porque también pasa las marcas de JVM y las opciones para cargar las bibliotecas nativas.El archivo JAR de implementación contiene todas las clases que encontraría un cargador de clases que buscó la ruta de clase desde la secuencia de comandos del wrapper del binario de principio a fin. También contiene las bibliotecas nativas necesarias para las dependencias. Se cargan automáticamente en la JVM durante el tiempo de ejecución.
Si tu objetivo especifica un atributo launcher, en lugar de ser un archivo JAR normal, _deploy.jar será un binario nativo. Contendrá el selector y cualquier dependencia nativa (C++) de tu regla, todas vinculadas en un objeto binario estático. Los bytes del archivo JAR real se agregarán a ese binario nativo, lo que creará un solo blob binario que contiene el ejecutable y el código Java. Puedes ejecutar el archivo JAR resultante directamente, como lo harías con cualquier objeto binario nativo.
name_deploy-src.jar
: Es un archivo que contiene las fuentes recopiladas de la clausura transitiva del destino. Estos coincidirán con las clases endeploy.jar
, excepto cuando los archivos jar no tengan ninguno de origen coincidente.
No se permite un atributo deps
en una regla java_binary
sin srcs
. Esa regla requiere un main_class
proporcionado por runtime_deps
.
En el siguiente fragmento de código, se muestra un error común:
java_binary( name = "DontDoThis", srcs = [ ...,"GeneratedJavaFile.java"
, # a generated .java file ], deps = [":generating_rule",
], # rule that generates that file )
En su lugar, haz lo siguiente:
java_binary( name = "DoThisInstead", srcs = [ ..., ":generating_rule", ], )
Argumentos
Atributos | |
---|---|
name |
Name; obligatorio Un nombre único para este destino. Se recomienda usar el nombre del archivo de origen que es el punto de entrada principal de la aplicación (menos la extensión). Por ejemplo, si tu punto de entrada se llama Main.java , entonces tu nombre podría ser Main .
|
deps
|
Lista de etiquetas; el valor predeterminado es deps en Atributos típicos definidos por la mayoría de las reglas de compilación.
|
srcs
|
Es una lista de etiquetas. El valor predeterminado es
Se compilan los archivos de origen de tipo
Se descomprimen y compilan los archivos fuente de tipo
Reglas: Si la regla (por lo general,
Este argumento casi siempre es obligatorio, a menos que un atributo |
resources
|
Es una lista de etiquetas. El valor predeterminado es
Si se especifican recursos, se agruparán en el archivo JAR junto con los archivos Los recursos pueden ser archivos fuente o generados. |
classpath_resources
|
Lista de etiquetas; el valor predeterminado es
Es una lista de recursos que se deben ubicar en la raíz del árbol de Java. El único propósito de este atributo es admitir bibliotecas de terceros que requieren que sus recursos se encuentren en la ruta de acceso de clases como |
create_executable
|
Booleano; no configurable; el valor predeterminado es java_single_jar en su lugar.
|
deploy_env
|
Lista de etiquetas; el valor predeterminado es java_binary que representan el entorno de implementación para este objeto binario.
Establece este atributo cuando compiles un complemento que cargará otro java_binary .Si configuras este atributo, se excluyen todas las dependencias de la ruta de acceso de tiempo de ejecución (y el archivo JAR de implementación) de este objeto binario que se comparten entre este objeto binario y los destinos especificados en deploy_env .
|
deploy_manifest_lines
|
Es una lista de cadenas. El valor predeterminado es META-INF/manifest.mf generado para el objetivo *_deploy.jar . El contenido de este atributo no está sujeto a la sustitución "Make variable".
|
javacopts
|
Es una lista de cadenas. El valor predeterminado es Estas opciones del compilador se pasan a javac después de las opciones globales del compilador. |
jvm_flags
|
Lista de cadenas; el valor predeterminado es La secuencia de comandos del wrapper para un objeto binario de Java incluye una definición de CLASSPATH (para encontrar todos los archivos jar dependientes) y, además, invoca al intérprete de Java correcto.
La línea de comandos que genera la secuencia de comandos del wrapper incluye el nombre
de la clase principal seguido de un Ten en cuenta que este atributo no tiene efecto en los resultados de |
launcher
|
Etiqueta; el valor predeterminado es bin/java normal que se incluye con el JDK.
El objetivo debe ser una cc_binary . Se puede especificar como valor de este atributo cualquier cc_binary que implemente la API de Java Invocation.
De forma predeterminada, Bazel usará el iniciador de JDK normal (bin/java o java.exe). La marca Ten en cuenta que tus dependencias nativas (C++, SWIG, JNI) se compilarán de manera diferente según si usas el selector de JDK o algún otro selector:
Cuando usas cualquier selector que no sea el selector predeterminado de JDK, cambia el formato del resultado de |
main_class
|
String; el valor predeterminado es main() que se usará como punto de entrada.
Si una regla usa esta opción, no necesita una lista srcs=[...] .
Por lo tanto, con este atributo, se puede hacer un ejecutable desde una biblioteca de Java que ya contiene uno o más métodos main() .
El valor de este atributo es un nombre de clase, no un archivo de origen. La clase debe estar disponible en el tiempo de ejecución: puede ser compilada por esta regla (desde |
plugins
|
Es una lista de etiquetas. El valor predeterminado es java_plugin especificado en este atributo se ejecutará cuando se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins . Los recursos que genera el complemento se incluirán en el archivo JAR resultante de esta regla.
|
resource_jars
|
Lista de etiquetas; el valor predeterminado es |
resource_strip_prefix
|
String; el valor predeterminado es
Si se especifica, este prefijo de ruta se quita de todos los archivos del atributo |
runtime_deps
|
Es una lista de etiquetas. El valor predeterminado es deps comunes, estos aparecerán en la ruta de clase del tiempo de ejecución, pero, a diferencia de ellos, no en la del tiempo de compilación. Las dependencias que solo se necesitan en el tiempo de ejecución deben enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los destinos que aparecen en runtime_deps y deps .
|
stamp
|
Número entero; el valor predeterminado es
Los objetos binarios sellados no se vuelven a compilar, a menos que cambien sus dependencias. |
use_launcher
|
Booleano; el valor predeterminado es Si este atributo se establece como falso, se ignorarán el atributo launcher y la marca |
use_testrunner
|
Booleano; el valor predeterminado es com.google.testing.junit.runner.BazelTestRunner de forma predeterminada) como el punto de entrada principal de un programa Java y proporciona la clase de prueba al ejecutor de pruebas como un valor de la propiedad del sistema bazel.test_suite .
Puedes usarlo para anular el comportamiento predeterminado, que es usar el ejecutor de pruebas para las reglas java_test y no usarlo para las reglas java_binary . Es poco probable que quieras hacerlo. Un uso es para las reglas AllTest
que invoca otra regla (para configurar una base de datos
antes de ejecutar las pruebas, por ejemplo). La regla AllTest se debe declarar como java_binary , pero aún debe usar el ejecutor de pruebas como su punto de entrada principal.
El nombre de una clase de ejecutor de pruebas se puede anular con el atributo main_class .
|
java_import
Ver la fuente de la reglajava_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)
Esta regla permite el uso de archivos .jar
previamente compilados como bibliotecas para reglas java_library
y java_binary
.
Ejemplos
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 |
Nombre: Obligatorio Un nombre único para este objetivo. |
deps
|
Lista de etiquetas; el valor predeterminado es |
constraints
|
Lista de cadenas; no configurable; el valor predeterminado es |
exports
|
Lista de etiquetas; el valor predeterminado es |
jars
|
Es una lista de etiquetas obligatoria. Es la lista de archivos JAR proporcionados a los destinos de Java que dependen de este destino. |
neverlink
|
Booleano; el valor predeterminado es tools.jar para todo lo que se ejecuta en un JDK estándar.
|
proguard_specs
|
Lista de etiquetas; el valor predeterminado es android_binary según esta biblioteca.
Los archivos incluidos aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, assumenosideeffects y reglas que comienzan con -keep. Otras opciones solo pueden aparecer en proguard_specs de android_binary para garantizar las combinaciones no tautológicas.
|
runtime_deps
|
Es una lista de etiquetas. El valor predeterminado es |
srcjar
|
Etiqueta; el valor predeterminado es |
java_library
Ver el origen de la reglajava_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 regla compila y vincula las fuentes en un archivo .jar
.
Objetivos de salida implícitos
libname.jar
: Un archivo Java que contiene los archivos de clase.libname-src.jar
: Es un archivo que contiene las fuentes ("archivo JAR de fuente").
Argumentos
Atributos | |
---|---|
name |
Name; obligatorio Un nombre único para este objetivo. |
deps
|
Es una lista de etiquetas. El valor predeterminado es deps en Atributos típicos definidos por la mayoría de las reglas de compilación.
Los archivos jar que compilan las reglas
Por el contrario, los destinos del atributo |
srcs
|
Lista de etiquetas; el valor predeterminado es
Se compilan los archivos de origen de tipo
Se descomprimen y compilan los archivos fuente de tipo
Reglas: Si la regla (por lo general,
Este argumento casi siempre es obligatorio, a menos que un atributo |
data
|
Lista de etiquetas; el valor predeterminado es data en Atributos típicos definidos por la mayoría de las reglas de compilación.
Cuando se compila un |
resources
|
Lista de etiquetas; el valor predeterminado es
Si se especifican los recursos, se agruparán en el jar con los archivos Los recursos pueden ser archivos fuente o generados. |
exported_plugins
|
Es una lista de etiquetas. El valor predeterminado es java_plugin (p. ej., procesadores de anotación) que se exportarán a bibliotecas que dependen directamente de esta biblioteca.
La lista especificada de |
exports
|
Lista de etiquetas; el valor predeterminado es
Si enumeras las reglas aquí, las pondrás a disposición de las reglas superiores, como si estas dependieran de forma explícita de ellas. Esto no es cierto para
Resumen: Una regla X puede acceder al código en Y si existe una ruta de dependencia entre ellos que comienza con un borde
Supongamos que A depende de B y B depende de C. En este caso, C es una dependencia transitiva de A, por lo que cambiar las fuentes de C y volver a compilar A volverá a compilar todo correctamente. Sin embargo, A no podrá usar clases en C. Para permitirlo, A debe declarar C en su El cierre de las bibliotecas exportadas está disponible para todas las reglas superiores directas. Tomemos un ejemplo ligeramente diferente: A depende de B, B depende de C y D, y también exporta C, pero no D. Ahora A tiene acceso a C, pero no a D. Ahora bien, si C y D exportaron algunas bibliotecas, C' y D' respectivamente, A solo podría acceder a C', pero no D'.
Importante: Una regla exportada no es una dependencia normal. Siguiendo con el ejemplo anterior,
si B exporta C y también quiere usar C, también debe incluirlo en su propio
|
javacopts
|
Es una lista de cadenas. El valor predeterminado es Estas opciones del compilador se pasan a javac después de las opciones globales del compilador. |
neverlink
|
Booleano; el valor predeterminado es tools.jar para cualquier elemento que se ejecute en un JDK estándar.
Ten en cuenta que Si la biblioteca en tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que solo difiera en los lugares en los que el JLS prohíbe que los compiladores se integren (y que debe ser compatible con todas las versiones futuras del JLS). |
plugins
|
Es una lista de etiquetas. El valor predeterminado es java_plugin especificado en este atributo se ejecutará cuando se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins . Los recursos que genera el complemento se incluirán en el archivo JAR resultante de esta regla.
|
proguard_specs
|
Es una lista de etiquetas. El valor predeterminado es android_binary según esta biblioteca.
Los archivos incluidos aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, supongan efectos secundarios y reglas que comiencen con -keep. Otras opciones solo pueden aparecer en proguard_specs de android_binary para garantizar las combinaciones no tautológicas.
|
resource_jars
|
Es una lista de etiquetas. El valor predeterminado es |
resource_strip_prefix
|
String; el valor predeterminado es
Si se especifica, este prefijo de ruta de acceso se quita de cada archivo en el atributo |
runtime_deps
|
Lista de etiquetas; el valor predeterminado es deps comunes, estos aparecerán en la ruta de clase del tiempo de ejecución, pero, a diferencia de ellos, no en la del tiempo de compilación. Las dependencias que solo se necesitan en el tiempo de ejecución deben enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los objetivos que aparecen en runtime_deps y deps .
|
java_lite_proto_library
Ver el origen de la reglajava_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
genera código Java a partir de archivos .proto
.
deps
debe apuntar a reglas proto_library
.
Ejemplo:
java_library( name = "lib", deps = [":foo"], ) java_lite_proto_library( name = "foo", deps = [":bar"], ) proto_library( name = "bar", )
Argumentos
Atributos | |
---|---|
name |
Name; obligatorio Un nombre único para este destino. |
deps
|
Es una lista de etiquetas. El valor predeterminado es proto_library para las que se generará código Java.
|
java_proto_library
Ver la fuente de la reglajava_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
genera código Java a partir de archivos .proto
.
deps
debe apuntar a las reglas proto_library
.
Ejemplo:
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; obligatorio Un nombre único para este destino. |
deps
|
Es una lista de etiquetas. El valor predeterminado es proto_library para las que se generará código Java.
|
java_test
Ver la fuente de la reglajava_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)
Una regla java_test()
compila una prueba de Java. Una prueba es un wrapper binario alrededor de tu código de prueba. Se invoca el método principal del ejecutor de pruebas en lugar de que se compile la clase principal.
Objetivos de salida implícitos
name.jar
: Es un archivo de Java.name_deploy.jar
: Es un archivo Java adecuado para la implementación. (Solo se compila si se solicita explícitamente). Consulta la descripción del resultadoname_deploy.jar
de java_binary para obtener más información.
Consulta la sección sobre argumentos de java_binary(). Esta regla también admite todos los atributos comunes a todas las reglas de prueba (*_test).
Ejemplos
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; obligatorio Un nombre único para este destino. |
deps
|
Es una lista de etiquetas. El valor predeterminado es deps en Atributos típicos definidos por la mayoría de las reglas de compilación.
|
srcs
|
Lista de etiquetas; el valor predeterminado es
Se compilan los archivos de origen de tipo
Se descomprimen y compilan los archivos fuente de tipo
Reglas: Si la regla (por lo general,
Este argumento casi siempre es obligatorio, excepto si un atributo |
resources
|
Es una lista de etiquetas. El valor predeterminado es
Si se especifican recursos, se agruparán en el archivo JAR junto con los archivos Los recursos pueden ser archivos fuente o generados. |
classpath_resources
|
Es una lista de etiquetas. El valor predeterminado es
Lista de recursos que deben estar ubicados en la raíz del árbol de Java. El único propósito de este atributo es admitir bibliotecas de terceros que requieren que sus recursos se encuentren en la ruta de acceso de clases como |
create_executable
|
Booleano; no configurable; el valor predeterminado es java_single_jar en su lugar.
|
deploy_manifest_lines
|
Lista de cadenas; el valor predeterminado es META-INF/manifest.mf generado para el destino *_deploy.jar . El contenido de este atributo no está sujeto a la sustitución "Make variable".
|
javacopts
|
Es una lista de cadenas. El valor predeterminado es Estas opciones del compilador se pasan a javac después de las opciones globales del compilador. |
jvm_flags
|
Lista de cadenas; el valor predeterminado es La secuencia de comandos del wrapper para un objeto binario de Java incluye una definición de CLASSPATH (para encontrar todos los archivos jar dependientes) y, además, invoca al intérprete de Java correcto.
La línea de comandos que genera la secuencia de comandos del wrapper incluye el nombre
de la clase principal seguido de un Ten en cuenta que este atributo no tiene efecto en los resultados de |
launcher
|
Etiqueta; el valor predeterminado es bin/java normal que se incluye con el JDK.
El objetivo debe ser un cc_binary . Se puede especificar como valor de este atributo cualquier cc_binary que implemente la API de Java Invocation.
De forma predeterminada, Bazel usará el selector de JDK normal (bin/java o java.exe). La marca Ten en cuenta que tus dependencias nativas (C++, SWIG, JNI) se compilarán de manera diferente según si usas el selector de JDK o algún otro:
Cuando se usa cualquier selector que no sea el selector predeterminado de JDK, cambia el formato de la salida de |
main_class
|
String; el valor predeterminado es main() que se usará como punto de entrada.
Si una regla usa esta opción, no necesita una lista srcs=[...] .
Por lo tanto, con este atributo, se puede hacer un ejecutable desde una biblioteca de Java que ya contiene uno o más métodos main() .
El valor de este atributo es un nombre de clase, no un archivo fuente. La clase debe estar disponible en el tiempo de ejecución: puede ser compilada por esta regla (desde |
plugins
|
Es una lista de etiquetas. El valor predeterminado es java_plugin especificado en este atributo se ejecutará cuando se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins . Los recursos
que genere el complemento se incluirán en el archivo JAR resultante de esta regla.
|
resource_jars
|
Es una lista de etiquetas. El valor predeterminado es |
resource_strip_prefix
|
String; el valor predeterminado es
Si se especifica, este prefijo de ruta de acceso se quita de todos los archivos del atributo |
runtime_deps
|
Es una lista de etiquetas. El valor predeterminado es deps comunes, estos aparecerán en la ruta de clase del tiempo de ejecución, pero, a diferencia de ellos, no en la del tiempo de compilación. Las dependencias que se necesitan solo en el entorno de ejecución deben
enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los destinos que aparecen en runtime_deps y deps .
|
stamp
|
Número entero; el valor predeterminado es
Los objetos binarios estampados no se vuelven a compilar, a menos que cambien sus dependencias. |
test_class
|
Cadena; el valor predeterminado es
De forma predeterminada, si no se define este argumento, se usa el modo heredado y, en su lugar, se usan los argumentos de prueba. Configura la marca
Este atributo especifica el nombre de una clase Java que ejecutará esta prueba. No es común establecer esta configuración. Si se omite este argumento, se inferirá mediante el
Para JUnit3, la clase de prueba debe ser una subclase de
Este atributo permite que varias reglas |
use_launcher
|
Booleano; el valor predeterminado es Si este atributo se establece como falso, se ignorarán el atributo launcher y la marca |
use_testrunner
|
Booleano; el valor predeterminado es com.google.testing.junit.runner.BazelTestRunner de forma predeterminada) como el punto de entrada principal de un programa Java y proporciona la clase de prueba al ejecutor de pruebas como un valor de la propiedad del sistema bazel.test_suite .
Puedes usarlo para anular el comportamiento predeterminado, que consiste en usar el ejecutor de pruebas para las reglas java_test y no para las reglas java_binary . Es poco probable que quieras hacerlo. Un uso es para las reglas AllTest
que invoca otra regla (para configurar una base de datos
antes de ejecutar las pruebas, por ejemplo). Se debe declarar la regla AllTest como java_binary , pero debe seguir usando el ejecutor de pruebas como su punto de entrada principal.
El nombre de una clase del ejecutor de pruebas se puede anular con el atributo main_class .
|
java_package_configuration
Ver la fuente de la reglajava_package_configuration(name, data, compatible_with, deprecation, distribs, features, javacopts, licenses, packages, restricted_to, tags, target_compatible_with, testonly, visibility)
Configuración que se aplica a un conjunto de paquetes.
Las configuraciones se pueden agregar a java_toolchain.javacopts
.
Ejemplo:
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; obligatorio Un nombre único para este destino. |
data
|
Es una lista de etiquetas. El valor predeterminado es |
javacopts
|
Es una lista de cadenas. El valor predeterminado es |
packages
|
Es una lista de etiquetas. El valor predeterminado es package_group a los que se debe aplicar la configuración.
|
java_plugin
Ver el origen de la reglajava_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 los complementos para el compilador de Java que ejecuta Bazel. Por el momento, el único tipo de complemento admitido son los procesadores de anotaciones. Una regla java_library
o java_binary
puede ejecutar complementos en función de ellos a través del atributo plugins
. Un java_library
también puede exportar automáticamente complementos a bibliotecas que dependen directamente de él mediante exported_plugins
.
Destinos de salida implícitos
libname.jar
: Un archivo Java.
Los argumentos son idénticos a java_library
, excepto por la adición del argumento processor_class
.
Argumentos
Atributos | |
---|---|
name |
Name; obligatorio Un nombre único para este destino. |
deps
|
Lista de etiquetas; el valor predeterminado es deps en Atributos típicos definidos por la mayoría de las reglas de compilación.
Los archivos jar que compilan las reglas
Por el contrario, los destinos del atributo |
srcs
|
Lista de etiquetas; el valor predeterminado es
Se compilan los archivos de origen de tipo
Se descomprimen y compilan los archivos fuente de tipo
Reglas: Si la regla (por lo general,
Este argumento casi siempre es obligatorio, excepto si un atributo |
data
|
Es una lista de etiquetas. El valor predeterminado es data en Atributos típicos definidos por la mayoría de las reglas de compilación.
Cuando compilas un |
resources
|
Es una lista de etiquetas. El valor predeterminado es
Si se especifican los recursos, se agruparán en el jar con los archivos Los recursos pueden ser archivos fuente o generados. |
generates_api
|
Booleano; el valor predeterminado es Si una regla usa un procesador de anotaciones que genera una API, otras reglas que dependen de ella pueden hacer referencia al código generado solo si sus acciones de compilación se programan después de la regla de generación. Este atributo le indica a Bazel que introduzca restricciones de programación cuando se habilite --java_header_compilation. ADVERTENCIA: Este atributo afecta el rendimiento de la compilación, úsalo solo si es necesario. |
javacopts
|
Lista de cadenas; el valor predeterminado es Estas opciones del compilador se pasan a javac después de las opciones globales del compilador. |
neverlink
|
Booleano; el valor predeterminado es tools.jar para cualquier elemento que se ejecute en un JDK estándar.
Ten en cuenta que Si la biblioteca en tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que solo difiera en los lugares en los que el JLS prohíbe que los compiladores se integren (y que debe ser compatible con todas las versiones futuras del JLS). |
output_licenses
|
Tipo de licencia (el valor predeterminado es common attributes
.
|
plugins
|
Es una lista de etiquetas. El valor predeterminado es java_plugin especificado en este atributo se ejecutará cada vez que se compile esta
regla. Una biblioteca también puede heredar complementos de dependencias que usan exported_plugins . Los recursos
que genere el complemento se incluirán en el archivo JAR resultante de esta regla.
|
processor_class
|
String; el valor predeterminado es |
proguard_specs
|
Es una lista de etiquetas. El valor predeterminado es android_binary según esta biblioteca.
Los archivos incluidos aquí solo deben tener reglas idempotentes, como -dontnote, -dontwarn, assumenosideeffects y reglas que comienzan con -keep. Otras opciones solo pueden aparecer en proguard_specs de android_binary para garantizar que las combinaciones no sean tautológicas.
|
resource_jars
|
Es una lista de etiquetas. El valor predeterminado es |
resource_strip_prefix
|
String; el valor predeterminado es
Si se especifica, este prefijo de ruta de acceso se quita de cada archivo en el atributo |
java_runtime
Ver el origen de la reglajava_runtime(name, srcs, compatible_with, default_cds, deprecation, distribs, features, hermetic_srcs, java, java_home, lib_ct_sym, lib_modules, licenses, restricted_to, tags, target_compatible_with, testonly, version, visibility)
Especifica la configuración de un entorno de ejecución de Java.
Ejemplo:
java_runtime( name = "jdk-9-ea+153", srcs = glob(["jdk9-ea+153/**"]), java_home = "jdk9-ea+153", )
Argumentos
Atributos | |
---|---|
name |
Nombre: Obligatorio Un nombre único para este objetivo. |
srcs
|
Lista de etiquetas; el valor predeterminado es |
default_cds
|
Etiqueta (Label); el valor predeterminado es java_runtime hermético. Cuando se habilita la hermeticidad para un destino java_binary y si el destino no proporciona su propio archivo CDS especificando el atributo classlist , el CDS predeterminado java_runtime se empaqueta en el JAR de implementación hermético.
|
hermetic_srcs
|
Es una lista de etiquetas. El valor predeterminado es |
java
|
Etiqueta (Label); el valor predeterminado es |
java_home
|
Cadena; el valor predeterminado es srcs y java deben estar vacíos.
|
lib_ct_sym
|
Etiqueta; el valor predeterminado es --release Si no se especifica y
hay exactamente un archivo en srcs cuya ruta de acceso termina con
/lib/ct.sym , se usa ese archivo.
|
lib_modules
|
Etiqueta; el valor predeterminado es |
version
|
Número entero; el valor predeterminado es Runtime.version().feature() .
|
java_toolchain
Ver el origen de la reglajava_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_worker_multiplex_sandboxing, javac_supports_workers, javacopts, jvm_opts, licenses, oneversion, oneversion_allowlist_for_tests, 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 la configuración del compilador Java. Se puede cambiar la cadena de herramientas que se usará a través del argumento --java_toolchain. Por lo general, no debes escribir ese tipo de reglas, a menos que quieras ajustar tu compilador de Java.
Ejemplos
Un ejemplo sencillo sería el siguiente:
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 |
Nombre: Obligatorio Un nombre único para este objetivo. |
android_lint_data
|
Lista de etiquetas; el valor predeterminado es |
android_lint_jvm_opts
|
Es una lista de cadenas. El valor predeterminado es |
android_lint_opts
|
Lista de cadenas; el valor predeterminado es |
android_lint_package_configuration
|
Lista de etiquetas; el valor predeterminado es |
android_lint_runner
|
Etiqueta (Label); el valor predeterminado es |
bootclasspath
|
Lista de etiquetas; el valor predeterminado es |
deps_checker
|
Es una lista de etiquetas. El valor predeterminado es |
forcibly_disable_header_compilation
|
Booleano; el valor predeterminado es |
genclass
|
Lista de etiquetas; obligatorio Etiqueta del archivo JAR de implementación de GenClass. |
header_compiler
|
Lista de etiquetas; el valor predeterminado es |
header_compiler_direct
|
Es una lista de etiquetas. El valor predeterminado es Esta herramienta no admite el procesamiento de anotaciones. |
ijar
|
Lista de etiquetas; obligatorio Etiqueta del ejecutable ijar. |
jacocorunner
|
Etiqueta (Label); el valor predeterminado es |
java_runtime
|
Label; obligatorio El java_runtime que se usará con esta cadena de herramientas. El valor predeterminado es java_runtime en la configuración de ejecución. |
javabuilder
|
Lista de etiquetas; obligatorio Etiqueta del archivo jar de implementación de JavaBuilder. |
javabuilder_data
|
Lista de etiquetas; el valor predeterminado es |
javabuilder_jvm_opts
|
Lista de cadenas; el valor predeterminado es |
javac_supports_multiplex_workers
|
Booleano; el valor predeterminado es |
javac_supports_worker_multiplex_sandboxing
|
Booleano; el valor predeterminado es |
javac_supports_workers
|
Booleano; el valor predeterminado es |
javacopts
|
Es una lista de cadenas. El valor predeterminado es |
jvm_opts
|
Es una lista de cadenas. El valor predeterminado es |
oneversion
|
Etiqueta (Label); el valor predeterminado es |
oneversion_allowlist_for_tests
|
Etiqueta (Label); el valor predeterminado es |
oneversion_whitelist
|
Etiqueta (Label); el valor predeterminado es |
package_configuration
|
Es una lista de etiquetas. El valor predeterminado es |
proguard_allowlister
|
Etiqueta; el valor predeterminado es |
resourcejar
|
Lista de etiquetas; el valor predeterminado es |
singlejar
|
Lista de etiquetas; obligatorio Etiqueta del archivo jar de implementación de SingleJar. |
source_version
|
Cadena; el valor predeterminado es |
target_version
|
Cadena; el valor predeterminado es |
timezone_data
|
Etiqueta; el valor predeterminado es |
tools
|
Es una lista de etiquetas. El valor predeterminado es |
turbine_data
|
Es una lista de etiquetas. El valor predeterminado es |
turbine_jvm_opts
|
Lista de cadenas; el valor predeterminado es |
xlint
|
Lista de cadenas; el valor predeterminado es |