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 el código 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 shell 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 mediante 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 correspondientes a las dependencias directas del objeto 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 jar de implementación contiene todas las clases que encontraría un cargador de clases que buscara la ruta de clase desde la secuencia de comandos del wrapper del objeto binario de principio a fin. También contiene las bibliotecas nativas necesarias para las dependencias. Estos se cargan automáticamente en la JVM durante el tiempo de ejecución.
Si el destino especifica un atributo launcher, en lugar de ser un archivo JAR normal, _deploy.jar será un objeto binario nativo. Este contendrá el selector y las dependencias nativas (C++) de tu regla, todas vinculadas en un objeto binario estático. Los bytes reales del archivo jar se adjuntarán a ese objeto binario nativo, lo que creará un único BLOB binario que contendrá el código 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 del cierre transitivo 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
. Dicha 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 (sin 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
|
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
|
Lista de etiquetas; el valor predeterminado es
Si se especifican recursos, se agruparán en el jar con los archivos Los recursos pueden ser archivos fuente o generados. |
classpath_resources
|
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 requieran que sus recursos se encuentren en la ruta de clase 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 .Cuando se configura este atributo, se excluyen todas las dependencias de la ruta de clase del entorno de ejecución (y del 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
|
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
|
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 las salidas |
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 cualquier cc_binary que implemente la
API de Java Invocation como un valor para este atributo.
De forma predeterminada, Bazel usará el iniciador de JDK normal (bin/java o java.exe). La marca de Bazel 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() para usar como punto de entrada.
Si una regla usa esta opción, no necesita una lista de 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
|
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
|
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 se necesitan solo en el entorno de ejecución deben
enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los objetivos 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 en falso, el atributo launcher y la marca |
use_testrunner
|
Booleano; el valor predeterminado es com.google.testing.junit.runner.BazelTestRunner ) como punto de entrada principal para un programa de 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 corresponde a las reglas de AllTest que invoca otra regla (por ejemplo, para configurar una base de datos antes de ejecutar las pruebas). 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_import
Ver el código 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
precompilados como bibliotecas para las 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 |
Name; obligatorio Un nombre único para este destino. |
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
|
Lista de etiquetas; obligatorio La lista de archivos JAR que se proporciona a los destinos de Java que dependen de este destino. |
neverlink
|
Booleano; el valor predeterminado es tools.jar para cualquier elemento que se ejecute 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, 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.
|
runtime_deps
|
Lista de etiquetas; el valor predeterminado es |
srcjar
|
Etiqueta; el valor predeterminado es |
java_library
Ver el código fuente 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 fuentes en un archivo .jar
.
Destinos de salida implícitos
libname.jar
: Es un archivo de Java que contiene los archivos de clase.libname-src.jar
: Es un archivo que contiene las fuentes ("jar de origen").
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 objetivos 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
|
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
|
Lista de etiquetas; el valor predeterminado es
Si se especifican recursos, se agruparán en el jar con los archivos Los recursos pueden ser archivos fuente o generados. |
exported_plugins
|
Lista de etiquetas; el valor predeterminado es java_plugin (p.ej., procesadores de anotaciones) para exportar a bibliotecas que dependen directamente de esta biblioteca.
La lista especificada de |
exports
|
Lista de etiquetas; el valor predeterminado es
Enumerar las reglas aquí las pondrán a disposición de las reglas superiores, como si los superiores dependieran de forma explícita de estas reglas. Esto no se aplica a
Resumen: Una regla X puede acceder al código en Y si existe una ruta de dependencia entre ellas que comience 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 de forma correcta. Sin embargo, A no podrá usar clases en C. Para permitir eso, A debe declarar C en su El cierre de las bibliotecas exportadas está disponible para todas las reglas superiores directas. Veamos 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 enumerarlo en su propio |
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). |
plugins
|
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.
|
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, 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
|
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 se necesitan solo en el entorno 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 código fuente 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 las 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
|
Lista de etiquetas; el valor predeterminado es proto_library para las que se generará código Java.
|
java_proto_library
Ver el código 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
|
Lista de etiquetas; el valor predeterminado es proto_library para las que se generará código Java.
|
java_test
Ver el código 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 que rodea tu código de prueba. Se invoca el método principal del ejecutor de pruebas en lugar de que se compile la clase principal.
Destinos 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
|
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
|
Lista de etiquetas; el valor predeterminado es
Si se especifican recursos, se agruparán en el jar con los archivos Los recursos pueden ser archivos fuente o generados. |
classpath_resources
|
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 requieran que sus recursos se encuentren en la ruta de clase 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
|
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 las salidas |
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 cualquier cc_binary que implemente la
API de Java Invocation como un valor para este atributo.
De forma predeterminada, Bazel usará el iniciador de JDK normal (bin/java o java.exe). La marca de Bazel 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() para usar como punto de entrada.
Si una regla usa esta opción, no necesita una lista de 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
|
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
|
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 se necesitan solo en el entorno de ejecución deben
enumerarse aquí. Las herramientas de análisis de dependencias deben ignorar los objetivos 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. |
test_class
|
String; el valor predeterminado es
De forma predeterminada, si este argumento no está definido, se usa el modo heredado y se usan los argumentos de prueba en su lugar. 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 en falso, el atributo launcher y la marca |
use_testrunner
|
Booleano; el valor predeterminado es com.google.testing.junit.runner.BazelTestRunner ) como punto de entrada principal para un programa de 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 corresponde a las reglas de AllTest que invoca otra regla (por ejemplo, para configurar una base de datos antes de ejecutar las pruebas). 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 el código 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.
Se pueden agregar configuraciones a los objetos 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
|
Lista de etiquetas; el valor predeterminado es |
javacopts
|
Lista de cadenas; el valor predeterminado es |
packages
|
Lista de etiquetas; el valor predeterminado es package_group a los que se debe aplicar la configuración.
|
java_plugin
Ver el código fuente 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 con exported_plugins
.
Destinos de salida implícitos
libname.jar
: Es un archivo de 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 objetivos 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
|
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
|
Lista de etiquetas; el valor predeterminado es
Si se especifican 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 API, otras reglas que dependen de este pueden hacer referencia al código generado solo si sus acciones de compilación están programadas después de la regla de generación. Este atributo le indica a Bazel que ingrese restricciones de programación cuando --java_header_compilation está habilitado. 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
|
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.
|
processor_class
|
String; el valor predeterminado es |
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, 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
|
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 código fuente 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 para 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 |
Name; obligatorio Un nombre único para este destino. |
srcs
|
Lista de etiquetas; el valor predeterminado es |
default_cds
|
Etiqueta; el valor predeterminado es java_runtime hermético. Cuando el CDS predeterminado está habilitado para un destino java_binary y el destino no proporciona su propio archivo CDS mediante la especificación del atributo classlist , el CDS predeterminado java_runtime se empaqueta en el JAR de implementación hermético.
|
hermetic_srcs
|
Lista de etiquetas; el valor predeterminado es |
java
|
Etiqueta; el valor predeterminado es |
java_home
|
String; 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 en /lib/ct.sym , se usará ese archivo.
|
lib_modules
|
Etiqueta; el valor predeterminado es |
version
|
Número entero; el valor predeterminado es Runtime.version().feature() .
|
java_toolchain
Ver el código fuente 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. La cadena de herramientas que se debe usar se puede cambiar a través del argumento --java_toolchain. Por lo general, no debes escribir ese tipo de reglas, a menos que desees 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 |
Name; obligatorio Un nombre único para este destino. |
android_lint_data
|
Lista de etiquetas; el valor predeterminado es |
android_lint_jvm_opts
|
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; el valor predeterminado es |
bootclasspath
|
Lista de etiquetas; el valor predeterminado es |
deps_checker
|
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
|
Lista de etiquetas; el valor predeterminado es Esta herramienta no admite el procesamiento de anotaciones. |
ijar
|
Lista de etiquetas; obligatorio Etiqueta del ejecutable de ijar. |
jacocorunner
|
Etiqueta; 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
|
Lista de cadenas; el valor predeterminado es |
jvm_opts
|
Lista de cadenas; el valor predeterminado es |
oneversion
|
Etiqueta; el valor predeterminado es |
oneversion_allowlist_for_tests
|
Etiqueta; el valor predeterminado es |
oneversion_whitelist
|
Etiqueta; el valor predeterminado es |
package_configuration
|
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
|
String; el valor predeterminado es |
target_version
|
String; el valor predeterminado es |
timezone_data
|
Etiqueta; el valor predeterminado es |
tools
|
Lista de etiquetas; el valor predeterminado es |
turbine_data
|
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 |