Se usó la API de Cloud Translation para traducir esta página.

Reglas de Java

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

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)

Compila un archivo Java ("archivo jar"), además de una secuencia de comandos de 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 otros elementos, un archivo JAR para cada biblioteca de la que depende el objeto binario.

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.

Objetivos 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 fuente").
name_deploy.jar: Es un archivo Java adecuado para la implementación (solo se compila si se solicita de forma explícita).
Si compilas el destino <name>_deploy.jar para tu regla, se creará un archivo JAR independiente con un manifiesto que permite ejecutarlo con el comando java -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 en lugar de java -jar, ya que también pasa las marcas de JVM y las opciones para cargar 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 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 tu destino especifica un atributo launcher, en lugar de ser un archivo JAR normal, _deploy.jar será un objeto binario nativo. Este incluirá el selector y las dependencias nativas (C++) de tu regla, todas vinculadas en un objeto binario estático. Los bytes del archivo jar real se agregarán a ese objeto binario nativo y se creará un solo BLOB binario que contendrá el código Java y el ejecutable. 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 de deploy.jar, excepto cuando los archivos jar no tengan un jar de origen coincidente.

No se permite un atributo deps en una regla java_binary sin srcs. Esta regla requiere una main_class proporcionada 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
)

Haz lo siguiente:

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

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino. Se recomienda usar el nombre del archivo de origen que representa el punto de entrada principal de la aplicación (menos la extensión). Por ejemplo, si tu punto de entrada se llama `Main.java`, tu nombre podría ser `Main`.
`deps`	`List of labels; optional` Es la lista de otras bibliotecas que se vincularán al destino. Consulta los comentarios generales sobre `deps` en Atributos típicos definidos por la mayoría de las reglas de compilación.
`srcs`	`List of labels; optional` La lista de archivos de origen que se procesan para crear el destino. Este atributo casi siempre es obligatorio; consulta las excepciones a continuación. Se compilan los archivos de origen de tipo `.java`. En el caso de los archivos `.java` generados, por lo general, se recomienda colocar aquí el nombre de la regla de generación, en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que también hace que la regla sea más resistente a los cambios futuros: si la regla de generación genera archivos diferentes en el futuro, solo necesitas corregir un lugar: el `outs` de la regla de generación. No debes enumerar la regla de generación en `deps` porque es una no-op. Se descomprimen y compilan los archivos de origen de tipo `.srcjar`. Esto resulta útil si necesitas generar un conjunto de archivos `.java` con una genrule. Reglas: Si la regla (por lo general, `genrule` o `filegroup`) genera alguno de los archivos mencionados con anterioridad, se usarán de la misma manera que se describió para los archivos de origen. Este argumento casi siempre es necesario, excepto si un atributo `main_class` especifica una clase en la ruta de clase de tiempo de ejecución o si especificas el argumento `runtime_deps`.
`resources`	`List of labels; optional` Lista de archivos de datos que se incluirán en un jar de Java. Si se especifican recursos, se agruparán en el jar junto con los archivos `.class` habituales producidos por la compilación. La estructura del proyecto determina la ubicación de los recursos dentro del archivo jar. Primero, Bazel busca el diseño estándar del directorio de Maven (un directorio "src" seguido de un directorio secundario "recursos"). Si no se encuentra, Bazel busca el directorio superior llamado "java" o "javatests" (por ejemplo, si un recurso se encuentra en `<workspace root>/x/java/y/java/z`, la ruta de acceso del recurso será `y/java/z`). Esta heurística no se puede anular; sin embargo, el atributo `resource_strip_prefix` se puede usar para especificar un directorio alternativo específico para los archivos de recursos. Los recursos pueden ser archivos fuente o generados.
`classpath_resources`	`List of labels; optional` NO USAR ESTA OPCIÓN, A MENOS QUE NO EXISTE DE OTRA FORMA) Lista de recursos que se deben ubicar en la raíz del árbol 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 exactamente como `"myconfig.xml"`. Debido al peligro de conflictos de espacio de nombres, solo se permite en objetos binarios, no en bibliotecas.
`create_executable`	`Boolean; optional; nonconfigurable; default is True` Indica si el objeto binario es ejecutable. Los objetos binarios no ejecutables recopilan dependencias transitivas de Java en un entorno de ejecución en un archivo jar de implementación, pero no se pueden ejecutar directamente. Si se configura este atributo, no se crea una secuencia de comandos de wrapper. Es un error establecer esto en 0 si se configuraron los atributos `launcher` o `main_class`.
`deploy_env`	`List of labels; optional` Es una lista de otros destinos `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`. La configuración de este atributo excluye todas las dependencias de la ruta de clase del tiempo de ejecución (y del 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`	`List of strings; optional` Una lista de líneas para agregar al archivo `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`	`List of strings; optional` Opciones adicionales del compilador para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
`jvm_flags`	`List of strings; optional` Una lista de marcas para incorporar en la secuencia de comandos del wrapper generada para ejecutar este objeto binario. Sujeto a la sustitución $(location) y "Make variable", y a la tokenización de la shell Bourne. La secuencia de comandos del wrapper para un objeto binario Java incluye una definición CLASSPATH (para encontrar todos los archivos jar dependientes) y, luego, invoca el 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 `"$@"` para que puedas pasar otros argumentos después del nombre de clase. Sin embargo, los argumentos destinados al análisis mediante JVM deben especificarse antes del nombre de clase en la línea de comandos. El contenido de `jvm_flags` se agrega a la secuencia de comandos del wrapper antes de que se muestre el nombre de clase. Ten en cuenta que este atributo no tiene efecto en los resultados de `*_deploy.jar`.
`launcher`	`Label; optional` Especifica un objeto binario que se usará para ejecutar tu programa Java en lugar del programa `bin/java` normal incluido con el JDK. El destino debe ser un `cc_binary`. Cualquier `cc_binary` que implemente la API de invocación de Java se puede especificar como un valor para este atributo. De forma predeterminada, Bazel usará el selector normal de JDK (bin/java o java.exe). La marca de Bazel `--java_launcher` relacionada afecta solo a los destinos `java_binary` y `java_test` que no especificaron un atributo `launcher`. Ten en cuenta que tus dependencias nativas (C++, SWIG, JNI) se compilarán de manera diferente según si usas el selector de JDK u otro selector: Si usas el selector normal de JDK (predeterminado), las dependencias nativas se compilan como una biblioteca compartida llamada `{name}_nativedeps.so`, en la que `{name}` es el atributo `name` de esta regla de java_binary. El vinculador no quita el código que no se use en esta configuración. Si usas cualquier otro selector, las dependencias nativas (C++) se vinculan de forma estática a un objeto binario llamado `{name}_nativedeps`, donde `{name}` es el atributo `name` de esta regla java_binary. En este caso, el vinculador quitará del objeto binario resultante cualquier código que considere que no se usa, lo que significa que no se podrá vincular ningún código C++ al que se acceda solo a través de JNI, a menos que el destino `cc_library` especifique `alwayslink = 1`. Cuando se usa cualquier selector que no sea el selector predeterminado de JDK, el formato de salida de `*_deploy.jar` cambia. Consulta los documentos principales de java_binary para obtener más información.
`main_class`	`String; optional` Nombre de la clase con el método `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 contenga 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 durante el tiempo de ejecución: se puede compilar mediante esta regla (de `srcs`) o a través de dependencias directas o transitivas (a través de `runtime_deps` o `deps`). Si la clase no está disponible, el objeto binario fallará en el tiempo de ejecución y no hay verificación de tiempo de compilación.
`plugins`	`List of labels; optional` Complementos del compilador de Java para ejecutar en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cuando se cree esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos generados por el complemento se incluirán en el archivo jar resultante de esta regla.
`resource_jars`	`List of labels; optional` Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
`resource_strip_prefix`	`String; optional` Prefijo de la ruta de acceso que se quitará de los recursos de Java. Si se especifica, este prefijo de ruta de acceso se quita de todos los archivos en el atributo `resources`. Es un error que un archivo de recursos no se encuentre en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso al archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos de origen. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Bibliotecas que estarán disponibles para el objeto binario final o la prueba solo durante el tiempo de ejecución. Al igual que los `deps` comunes, estos aparecerán en la ruta de clase de tiempo de ejecución, pero, a diferencia de ellos, no en la ruta de clase de tiempo de compilación. Aquí se deben enumerar las dependencias que solo se necesitan en el entorno de ejecución. Las herramientas de análisis de dependencias deben ignorar los objetivos que aparecen en `runtime_deps` y `deps`.
`stamp`	`Integer; optional; default is -1` Indica si se debe codificar la información de compilación en el objeto binario. Valores posibles: `stamp = 1`: Siempre marca la información de compilación en el objeto binario, incluso en compilaciones de `--nostamp`. Esta configuración debe evitarse, ya que podría finalizar el almacenamiento en caché remoto del objeto binario y todas las acciones descendentes que dependen de él. `stamp = 0`: Siempre reemplaza la información de compilación por valores constantes. Esto proporciona un buen almacenamiento en caché de resultados de compilación. `stamp = -1`: La marca `--[no]stamp` controla la incorporación de la información de compilación. Los objetos binarios sellados no se vuelven a compilar, a menos que cambien sus dependencias.
`use_launcher`	`Boolean; optional; default is True` Indica si el objeto binario debe usar un selector personalizado. Si este atributo se establece como falso, se ignorarán el atributo del selector y la marca `--java_launcher` relacionada para este destino.
`use_testrunner`	`Boolean; optional; default is False` Usa la clase del ejecutor de pruebas (`com.google.testing.junit.runner.BazelTestRunner` de forma predeterminada) como punto de entrada principal para un programa Java y proporciona la clase de prueba al ejecutor de pruebas como un valor de 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 hacer esto. Un uso es para las reglas `AllTest` que invoca otra regla (por ejemplo, configurar una base de datos antes de ejecutar las pruebas). Se debe declarar la regla `AllTest` como `java_binary`, pero debería 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

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)

Esta regla permite el uso de archivos .jar ya 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`	`Name; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Es la lista de otras bibliotecas que se vincularán al destino. Consulta java_library.deps.
`constraints`	`List of strings; optional; nonconfigurable` Restricciones adicionales impuestas a esta regla como una biblioteca de Java.
`exports`	`List of labels; optional` Destinos que se ponen a disposición de los usuarios de esta regla. Consulta java_library.exports.
`jars`	`List of labels; required` Es la lista de archivos JAR proporcionada a los destinos de Java que dependen de él.
`neverlink`	`Boolean; optional; default is False` Solo usa esta biblioteca para la compilación y no durante el tiempo de ejecución. Es útil si el entorno de ejecución proporciona la biblioteca durante la ejecución. Algunos ejemplos de bibliotecas como esta son las APIs de IDE para complementos de IDE o `tools.jar` para cualquier elemento que se ejecute en un JDK estándar.
`proguard_specs`	`List of labels; optional` Archivos que se usarán como especificación de ProGuard. Estos describirán el conjunto de especificaciones que ProGuard usará. Si se especifican, se agregarán a cualquier destino `android_binary` según esta biblioteca. Los archivos que se incluyen aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, asunción de efectos secundarios y reglas que comienzan con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`runtime_deps`	`List of labels; optional` Bibliotecas que estarán disponibles para el objeto binario final o la prueba solo durante el tiempo de ejecución. Consulta java_library.runtime_deps.
`srcjar`	`Label; optional` Un archivo JAR que contiene el código fuente para los archivos 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 regla compila y vincula fuentes en un archivo .jar.

Objetivos de salida implícitos

libname.jar: Es un archivo Java que contiene los archivos de la clase.
libname-src.jar: Es un archivo que contiene las fuentes ("jar fuente").

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Es la lista de bibliotecas que se vincularán a esta biblioteca. Consulta los comentarios generales sobre `deps` en Atributos típicos definidos por la mayoría de las reglas de compilación. Los archivos jar compilados por las reglas `java_library` enumeradas en `deps` estarán en la ruta de clase en tiempo de compilación de esta regla. Además, el cierre transitivo de sus `deps`, `runtime_deps` y `exports` estará en la ruta de clase del tiempo de ejecución. Por el contrario, los objetivos del atributo `data` se incluyen en los archivos de ejecución, pero no en la ruta de clase de tiempo de compilación ni de tiempo de ejecución.
`srcs`	`List of labels; optional` La lista de archivos de origen que se procesan para crear el destino. Este atributo casi siempre es obligatorio; consulta las excepciones a continuación. Se compilan los archivos de origen de tipo `.java`. En el caso de los archivos `.java` generados, por lo general, se recomienda colocar aquí el nombre de la regla de generación, en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que también hace que la regla sea más resistente a los cambios futuros: si la regla de generación genera archivos diferentes en el futuro, solo necesitas corregir un lugar: el `outs` de la regla de generación. No debes enumerar la regla de generación en `deps` porque es una no-op. Se descomprimen y compilan los archivos de origen de tipo `.srcjar`. Esto resulta útil si necesitas generar un conjunto de archivos `.java` con una genrule. Reglas: Si la regla (por lo general, `genrule` o `filegroup`) genera alguno de los archivos mencionados con anterioridad, se usarán de la misma manera que se describió para los archivos de origen. Este argumento casi siempre es necesario, excepto si un atributo `main_class` especifica una clase en la ruta de clase de tiempo de ejecución o si especificas el argumento `runtime_deps`.
`data`	`List of labels; optional` La lista de archivos que necesita esta biblioteca durante el tiempo de ejecución. Consulta los comentarios generales sobre `data` en Atributos típicos definidos por la mayoría de las reglas de compilación. Cuando compilas un `java_library`, Bazel no coloca estos archivos en ningún lugar; si los archivos `data` son archivos generados, Bazel los genera. Cuando compilas una prueba que depende de este `java_library`, Bazel copia o vincula los archivos `data` al área de archivos de ejecución.
`resources`	`List of labels; optional` Lista de archivos de datos que se incluirán en un jar de Java. Si se especifican recursos, se agruparán en el jar junto con los archivos `.class` habituales producidos por la compilación. La estructura del proyecto determina la ubicación de los recursos dentro del archivo jar. Primero, Bazel busca el diseño estándar del directorio de Maven (un directorio "src" seguido de un directorio secundario "recursos"). Si no se encuentra, Bazel busca el directorio superior llamado "java" o "javatests" (por ejemplo, si un recurso se encuentra en `<workspace root>/x/java/y/java/z`, la ruta de acceso del recurso será `y/java/z`). Esta heurística no se puede anular; sin embargo, el atributo `resource_strip_prefix` se puede usar para especificar un directorio alternativo específico para los archivos de recursos. Los recursos pueden ser archivos fuente o generados.
`exported_plugins`	`List of labels; optional` Es la lista de `java_plugin` (p.ej., procesadores de anotaciones) para exportar a bibliotecas que dependen directamente de esta biblioteca. La lista especificada de `java_plugin` se aplicará a cualquier biblioteca que dependa directamente de esta biblioteca, como si la biblioteca hubiera declarado explícitamente estas etiquetas en `plugins`.
`exports`	`List of labels; optional` Bibliotecas exportadas Si enumeras las reglas aquí, estarán disponibles para las reglas superiores, como si las reglas superiores dependieran de ellas de forma explícita. Esto no es así para los `deps` normales (no exportados) Resumen: Una regla X puede acceder al código de Y si existe una ruta de dependencia entre ellas que comienza con una arista `deps` seguida de cero o más aristas `exports`. Veamos algunos ejemplos que lo ilustran. Supongamos que A depende de B y que 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 ello, A tiene que declarar C en su `deps`, o bien B puede facilitarle a A (y todo lo que dependa de A) declarando C en su atributo `exports` (de la B). El cierre de las bibliotecas exportadas está disponible para todas las reglas superiores directas. Observa 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, si C y D exportaron algunas bibliotecas, C' y D' respectivamente, A solo podría acceder a C', pero no a D'. Importante: Una regla exportada no es una dependencia normal. Según el ejemplo anterior, si B exporta C y también desea usar C, debe enumerarlo en su propio `deps`.
`javacopts`	`List of strings; optional` Opciones adicionales del compilador para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
`neverlink`	`Boolean; optional; default is False` Indica si esta biblioteca solo debe usarse para la compilación y no durante el tiempo de ejecución. Es útil si el entorno de ejecución proporciona la biblioteca durante la ejecución. Algunos ejemplos de esas bibliotecas son las APIs de IDE para complementos de IDE o `tools.jar` para cualquier elemento que se ejecute en un JDK estándar. Ten en cuenta que `neverlink = 1` no impide que el compilador incorpore material de esta biblioteca en objetivos de compilación que dependan de ella, como lo permite la especificación del lenguaje Java (p.ej., `static final` de `String` o de tipos primitivos). Por lo tanto, el caso práctico preferido es cuando la biblioteca en tiempo de ejecución es idéntica a la biblioteca de compilación. Si la biblioteca en tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que lo haga solo en lugares en los que el JLS prohíbe que los compiladores se encarguen (y se debe mantener para todas las versiones futuras de JLS).
`plugins`	`List of labels; optional` Complementos del compilador de Java para ejecutar en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cuando se cree esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos generados por el complemento se incluirán en el archivo jar resultante de esta regla.
`proguard_specs`	`List of labels; optional` Archivos que se usarán como especificación de ProGuard. Estos describirán el conjunto de especificaciones que ProGuard usará. Si se especifican, se agregarán a cualquier destino `android_binary` según esta biblioteca. Los archivos que se incluyen aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, asunción de efectos secundarios y reglas que comienzan con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`resource_jars`	`List of labels; optional` Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
`resource_strip_prefix`	`String; optional` Prefijo de la ruta de acceso que se quitará de los recursos de Java. Si se especifica, este prefijo de ruta de acceso se quita de todos los archivos en el atributo `resources`. Es un error que un archivo de recursos no se encuentre en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso al archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos de origen. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Bibliotecas que estarán disponibles para el objeto binario final o la prueba solo durante el tiempo de ejecución. Al igual que los `deps` comunes, estos aparecerán en la ruta de clase de tiempo de ejecución, pero, a diferencia de ellos, no en la ruta de clase de tiempo de compilación. Aquí se deben enumerar las dependencias que solo se necesitan en el entorno de ejecución. Las herramientas de análisis de dependencias deben ignorar los objetivos que aparecen en `runtime_deps` y `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 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; required

Un nombre único para este destino.

deps

List of labels; optional

La lista de reglas proto_library para las que se genera 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 genera código Java a partir de archivos .proto.

deps debe apuntar a 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; required

Un nombre único para este destino.

deps

List of labels; optional

La lista de reglas proto_library para las que se genera 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)

Una regla java_test() compila una prueba de Java. Una prueba es un wrapper binario alrededor del código de prueba. Se invoca el método principal del ejecutor de pruebas en lugar de compilarse la clase principal.

Objetivos de salida implícitos

name.jar: Es un archivo 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 resultado de name_deploy.jar de java_binary para obtener más detalles.

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; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Es la lista de otras bibliotecas que se vincularán al destino. Consulta los comentarios generales sobre `deps` en Atributos típicos definidos por la mayoría de las reglas de compilación.
`srcs`	`List of labels; optional` La lista de archivos de origen que se procesan para crear el destino. Este atributo casi siempre es obligatorio; consulta las excepciones a continuación. Se compilan los archivos de origen de tipo `.java`. En el caso de los archivos `.java` generados, por lo general, se recomienda colocar aquí el nombre de la regla de generación, en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que también hace que la regla sea más resistente a los cambios futuros: si la regla de generación genera archivos diferentes en el futuro, solo necesitas corregir un lugar: el `outs` de la regla de generación. No debes enumerar la regla de generación en `deps` porque es una no-op. Se descomprimen y compilan los archivos de origen de tipo `.srcjar`. Esto resulta útil si necesitas generar un conjunto de archivos `.java` con una genrule. Reglas: Si la regla (por lo general, `genrule` o `filegroup`) genera alguno de los archivos mencionados con anterioridad, se usarán de la misma manera que se describió para los archivos de origen. Este argumento casi siempre es necesario, excepto si un atributo `main_class` especifica una clase en la ruta de clase de tiempo de ejecución o si especificas el argumento `runtime_deps`.
`resources`	`List of labels; optional` Lista de archivos de datos que se incluirán en un jar de Java. Si se especifican recursos, se agruparán en el jar junto con los archivos `.class` habituales producidos por la compilación. La estructura del proyecto determina la ubicación de los recursos dentro del archivo jar. Primero, Bazel busca el diseño estándar del directorio de Maven (un directorio "src" seguido de un directorio secundario "recursos"). Si no se encuentra, Bazel busca el directorio superior llamado "java" o "javatests" (por ejemplo, si un recurso se encuentra en `<workspace root>/x/java/y/java/z`, la ruta de acceso del recurso será `y/java/z`). Esta heurística no se puede anular; sin embargo, el atributo `resource_strip_prefix` se puede usar para especificar un directorio alternativo específico para los archivos de recursos. Los recursos pueden ser archivos fuente o generados.
`classpath_resources`	`List of labels; optional` NO USAR ESTA OPCIÓN, A MENOS QUE NO EXISTE DE OTRA FORMA) Lista de recursos que se deben ubicar en la raíz del árbol 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 exactamente como `"myconfig.xml"`. Debido al peligro de conflictos de espacio de nombres, solo se permite en objetos binarios, no en bibliotecas.
`create_executable`	`Boolean; optional; nonconfigurable; default is True` Indica si el objeto binario es ejecutable. Los objetos binarios no ejecutables recopilan dependencias transitivas de Java en un entorno de ejecución en un archivo jar de implementación, pero no se pueden ejecutar directamente. Si se configura este atributo, no se crea una secuencia de comandos de wrapper. Es un error establecer esto en 0 si se configuraron los atributos `launcher` o `main_class`.
`deploy_manifest_lines`	`List of strings; optional` Una lista de líneas para agregar al archivo `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`	`List of strings; optional` Opciones adicionales del compilador para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
`jvm_flags`	`List of strings; optional` Una lista de marcas para incorporar en la secuencia de comandos del wrapper generada para ejecutar este objeto binario. Sujeto a la sustitución $(location) y "Make variable", y a la tokenización de la shell Bourne. La secuencia de comandos del wrapper para un objeto binario Java incluye una definición CLASSPATH (para encontrar todos los archivos jar dependientes) y, luego, invoca el 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 `"$@"` para que puedas pasar otros argumentos después del nombre de clase. Sin embargo, los argumentos destinados al análisis mediante JVM deben especificarse antes del nombre de clase en la línea de comandos. El contenido de `jvm_flags` se agrega a la secuencia de comandos del wrapper antes de que se muestre el nombre de clase. Ten en cuenta que este atributo no tiene efecto en los resultados de `*_deploy.jar`.
`launcher`	`Label; optional` Especifica un objeto binario que se usará para ejecutar tu programa Java en lugar del programa `bin/java` normal incluido con el JDK. El destino debe ser un `cc_binary`. Cualquier `cc_binary` que implemente la API de invocación de Java se puede especificar como un valor para este atributo. De forma predeterminada, Bazel usará el selector normal de JDK (bin/java o java.exe). La marca de Bazel `--java_launcher` relacionada afecta solo a los destinos `java_binary` y `java_test` que no especificaron un atributo `launcher`. Ten en cuenta que tus dependencias nativas (C++, SWIG, JNI) se compilarán de manera diferente según si usas el selector de JDK u otro selector: Si usas el selector normal de JDK (predeterminado), las dependencias nativas se compilan como una biblioteca compartida llamada `{name}_nativedeps.so`, en la que `{name}` es el atributo `name` de esta regla de java_binary. El vinculador no quita el código que no se use en esta configuración. Si usas cualquier otro selector, las dependencias nativas (C++) se vinculan de forma estática a un objeto binario llamado `{name}_nativedeps`, donde `{name}` es el atributo `name` de esta regla java_binary. En este caso, el vinculador quitará del objeto binario resultante cualquier código que considere que no se usa, lo que significa que no se podrá vincular ningún código C++ al que se acceda solo a través de JNI, a menos que el destino `cc_library` especifique `alwayslink = 1`. Cuando se usa cualquier selector que no sea el selector predeterminado de JDK, el formato de salida de `*_deploy.jar` cambia. Consulta los documentos principales de java_binary para obtener más información.
`main_class`	`String; optional` Nombre de la clase con el método `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 contenga 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 durante el tiempo de ejecución: se puede compilar mediante esta regla (de `srcs`) o a través de dependencias directas o transitivas (a través de `runtime_deps` o `deps`). Si la clase no está disponible, el objeto binario fallará en el tiempo de ejecución y no hay verificación de tiempo de compilación.
`plugins`	`List of labels; optional` Complementos del compilador de Java para ejecutar en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cuando se cree esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos generados por el complemento se incluirán en el archivo jar resultante de esta regla.
`resource_jars`	`List of labels; optional` Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
`resource_strip_prefix`	`String; optional` Prefijo de la ruta de acceso que se quitará de los recursos de Java. Si se especifica, este prefijo de ruta de acceso se quita de todos los archivos en el atributo `resources`. Es un error que un archivo de recursos no se encuentre en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso al archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos de origen. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Bibliotecas que estarán disponibles para el objeto binario final o la prueba solo durante el tiempo de ejecución. Al igual que los `deps` comunes, estos aparecerán en la ruta de clase de tiempo de ejecución, pero, a diferencia de ellos, no en la ruta de clase de tiempo de compilación. Aquí se deben enumerar las dependencias que solo se necesitan en el entorno de ejecución. Las herramientas de análisis de dependencias deben ignorar los objetivos que aparecen en `runtime_deps` y `deps`.
`stamp`	`Integer; optional; default is 0` Indica si se debe codificar la información de compilación en el objeto binario. Valores posibles: `stamp = 1`: Siempre marca la información de compilación en el objeto binario, incluso en compilaciones de `--nostamp`. Esta configuración debe evitarse, ya que podría finalizar el almacenamiento en caché remoto del objeto binario y todas las acciones descendentes que dependen de él. `stamp = 0`: Siempre reemplaza la información de compilación por valores constantes. Esto proporciona un buen almacenamiento en caché de resultados de compilación. `stamp = -1`: La marca `--[no]stamp` controla la incorporación de la información de compilación. Los objetos binarios sellados no se vuelven a compilar, a menos que cambien sus dependencias.
`test_class`	`String; optional` Es la clase Java que cargará el ejecutor de pruebas. De forma predeterminada, si este argumento no está definido, se usa el modo heredado y, en su lugar, se usan los argumentos de prueba. Establece la marca `--nolegacy_bazel_java_test` para que no sea resguardo en el primer argumento. Este atributo especifica el nombre de una clase de Java que ejecutará esta prueba. Es raro que se necesite configurar esto. Si se omite este argumento, se inferirá mediante el `name` de destino y su ruta relativa de la raíz de la fuente. Si la prueba se encuentra fuera de una raíz de origen conocida, Bazel informará un error si no se configura `test_class`. Para JUnit3, la clase de prueba debe ser una subclase de `junit.framework.TestCase` o debe tener un método `suite()` estático público que muestre un `junit.framework.Test` (o una subclase de `Test`). En el caso de JUnit4, la clase debe tener la anotación `org.junit.runner.RunWith`. Este atributo permite que varias reglas `java_test` compartan el mismo `Test` (`TestCase`, `TestSuite`, ...). Por lo general, se le pasa información adicional (p.ej., a través de `jvm_flags=['-Dkey=value']`) para que su comportamiento difiera en cada caso, como ejecutar un subconjunto diferente de las pruebas. Este atributo también habilita el uso de pruebas de Java fuera del árbol `javatests`.
`use_launcher`	`Boolean; optional; default is True` Indica si el objeto binario debe usar un selector personalizado. Si este atributo se establece como falso, se ignorarán el atributo del selector y la marca `--java_launcher` relacionada para este destino.
`use_testrunner`	`Boolean; optional; default is True` Usa la clase del ejecutor de pruebas (`com.google.testing.junit.runner.BazelTestRunner` de forma predeterminada) como punto de entrada principal para un programa Java y proporciona la clase de prueba al ejecutor de pruebas como un valor de 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 hacer esto. Un uso es para las reglas `AllTest` que invoca otra regla (por ejemplo, configurar una base de datos antes de ejecutar las pruebas). Se debe declarar la regla `AllTest` como `java_binary`, pero debería 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

java_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 parámetros de configuración a 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; required` Un nombre único para este destino.
`data`	`List of labels; optional` La lista de archivos que necesita esta configuración en el entorno de ejecución.
`javacopts`	`List of strings; optional` Marcas del compilador de Java.
`packages`	`List of labels; optional` El conjunto de `package_group` al que se debe aplicar la configuración.

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 complementos para el compilador de Java que ejecuta Bazel. Por el momento, los únicos complementos compatibles son los procesadores de anotaciones. Una regla java_library o java_binary puede ejecutar complementos según ellos mediante el atributo plugins. Un java_library también puede exportar automáticamente complementos a bibliotecas que dependen directamente de él mediante exported_plugins.

Objetivos de salida implícitos

libname.jar: Es un archivo Java.

Los argumentos son idénticos a java_library, excepto por la adición del argumento processor_class.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este destino.
`deps`	`List of labels; optional` Es la lista de bibliotecas que se vincularán a esta biblioteca. Consulta los comentarios generales sobre `deps` en Atributos típicos definidos por la mayoría de las reglas de compilación. Los archivos jar compilados por las reglas `java_library` enumeradas en `deps` estarán en la ruta de clase en tiempo de compilación de esta regla. Además, el cierre transitivo de sus `deps`, `runtime_deps` y `exports` estará en la ruta de clase del tiempo de ejecución. Por el contrario, los objetivos del atributo `data` se incluyen en los archivos de ejecución, pero no en la ruta de clase de tiempo de compilación ni de tiempo de ejecución.
`srcs`	`List of labels; optional` La lista de archivos de origen que se procesan para crear el destino. Este atributo casi siempre es obligatorio; consulta las excepciones a continuación. Se compilan los archivos de origen de tipo `.java`. En el caso de los archivos `.java` generados, por lo general, se recomienda colocar aquí el nombre de la regla de generación, en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que también hace que la regla sea más resistente a los cambios futuros: si la regla de generación genera archivos diferentes en el futuro, solo necesitas corregir un lugar: el `outs` de la regla de generación. No debes enumerar la regla de generación en `deps` porque es una no-op. Se descomprimen y compilan los archivos de origen de tipo `.srcjar`. Esto resulta útil si necesitas generar un conjunto de archivos `.java` con una genrule. Reglas: Si la regla (por lo general, `genrule` o `filegroup`) genera alguno de los archivos mencionados con anterioridad, se usarán de la misma manera que se describió para los archivos de origen. Este argumento casi siempre es necesario, excepto si un atributo `main_class` especifica una clase en la ruta de clase de tiempo de ejecución o si especificas el argumento `runtime_deps`.
`data`	`List of labels; optional` La lista de archivos que necesita esta biblioteca durante el tiempo de ejecución. Consulta los comentarios generales sobre `data` en Atributos típicos definidos por la mayoría de las reglas de compilación. Cuando compilas un `java_library`, Bazel no coloca estos archivos en ningún lugar; si los archivos `data` son archivos generados, Bazel los genera. Cuando compilas una prueba que depende de este `java_library`, Bazel copia o vincula los archivos `data` al área de archivos de ejecución.
`resources`	`List of labels; optional` Lista de archivos de datos que se incluirán en un jar de Java. Si se especifican recursos, se agruparán en el jar junto con los archivos `.class` habituales producidos por la compilación. La estructura del proyecto determina la ubicación de los recursos dentro del archivo jar. Primero, Bazel busca el diseño estándar del directorio de Maven (un directorio "src" seguido de un directorio secundario "recursos"). Si no se encuentra, Bazel busca el directorio superior llamado "java" o "javatests" (por ejemplo, si un recurso se encuentra en `<workspace root>/x/java/y/java/z`, la ruta de acceso del recurso será `y/java/z`). Esta heurística no se puede anular; sin embargo, el atributo `resource_strip_prefix` se puede usar para especificar un directorio alternativo específico para los archivos de recursos. Los recursos pueden ser archivos fuente o generados.
`generates_api`	`Boolean; optional; default is False` Este atributo marca los procesadores de anotaciones que generan código de API. Si una regla usa un procesador de anotaciones que genera la API, las otras reglas que dependen de él 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 introduzca restricciones de programación cuando --java_header_compilation esté habilitada. ADVERTENCIA: Este atributo afecta el rendimiento de la compilación. Úsalo solo si es necesario.
`javacopts`	`List of strings; optional` Opciones adicionales del compilador para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones globales del compilador.
`neverlink`	`Boolean; optional; default is False` Indica si esta biblioteca solo debe usarse para la compilación y no durante el tiempo de ejecución. Es útil si el entorno de ejecución proporciona la biblioteca durante la ejecución. Algunos ejemplos de esas bibliotecas son las APIs de IDE para complementos de IDE o `tools.jar` para cualquier elemento que se ejecute en un JDK estándar. Ten en cuenta que `neverlink = 1` no impide que el compilador incorpore material de esta biblioteca en objetivos de compilación que dependan de ella, como lo permite la especificación del lenguaje Java (p.ej., `static final` de `String` o de tipos primitivos). Por lo tanto, el caso práctico preferido es cuando la biblioteca en tiempo de ejecución es idéntica a la biblioteca de compilación. Si la biblioteca en tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que lo haga solo en lugares en los que el JLS prohíbe que los compiladores se encarguen (y se debe mantener para todas las versiones futuras de JLS).
`output_licenses`	`Licence type; optional` Consulta `common attributes`.
`plugins`	`List of labels; optional` Complementos del compilador de Java para ejecutar en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cuando se cree esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos generados por el complemento se incluirán en el archivo jar resultante de esta regla.
`processor_class`	`String; optional` La clase de procesador es el tipo completamente calificado de la clase que el compilador de Java debe usar como punto de entrada al procesador de anotaciones. Si no se especifica, esta regla no contribuirá con un procesador de anotaciones al procesamiento de anotaciones del compilador de Java, pero su ruta de clase de tiempo de ejecución se incluirá en la ruta de acceso del procesador de anotaciones del compilador. (principalmente, para que lo usen los complementos propensos a errores, que se cargan desde la ruta del procesador de anotaciones mediante java.util.ServiceLoader).
`proguard_specs`	`List of labels; optional` Archivos que se usarán como especificación de ProGuard. Estos describirán el conjunto de especificaciones que ProGuard usará. Si se especifican, se agregarán a cualquier destino `android_binary` según esta biblioteca. Los archivos que se incluyen aquí solo deben tener reglas idempotentes, es decir, -dontnote, -dontwarn, asunción de efectos secundarios y reglas que comienzan con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`resource_jars`	`List of labels; optional` Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
`resource_strip_prefix`	`String; optional` Prefijo de la ruta de acceso que se quitará de los recursos de Java. Si se especifica, este prefijo de ruta de acceso se quita de todos los archivos en el atributo `resources`. Es un error que un archivo de recursos no se encuentre en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso al archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos de origen. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `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 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`	`Name; required` Un nombre único para este destino.
`srcs`	`List of labels; optional` Todos los archivos en el entorno de ejecución
`hermetic_srcs`	`List of labels; optional` Archivos en el entorno de ejecución necesarios para implementaciones herméticas.
`java`	`Label; optional` Es la ruta de acceso al archivo ejecutable de Java.
`java_home`	`String; optional` La ruta de acceso a la raíz del entorno de ejecución. Sujeto a la sustitución de la variable"Make". Si esta ruta de acceso es absoluta, la regla denota un entorno de ejecución de Java no hermético con una ruta de acceso conocida. En ese caso, los atributos `srcs` y `java` deben estar vacíos.
`lib_modules`	`Label; optional` El archivo lib/modules necesario para implementaciones 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 la configuración del compilador de Java. La cadena de herramientas que se usa se puede cambiar con el 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:

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` Un nombre único para este destino.
`android_lint_data`	`List of labels; optional` Etiquetas de herramientas disponibles para la expansión de etiquetas en android_lint_jvm_opts.
`android_lint_jvm_opts`	`List of strings; optional` Lista de argumentos para la JVM cuando se invoca Android Lint.
`android_lint_opts`	`List of strings; optional` Lista de argumentos de Android Lint
`android_lint_package_configuration`	`List of labels; optional` Configuración de Android Lint que se debe aplicar a los grupos de paquetes especificados.
`android_lint_runner`	`Label; optional` Etiqueta del ejecutor de Android Lint, si corresponde.
`bootclasspath`	`List of labels; optional` Las entradas de bootclasspath de destino de Java. Corresponde a la marca -bootclasspath de javac.
`deps_checker`	`List of labels; optional` Etiqueta del archivo jar de implementación de ImportDepsChecker.
`forcibly_disable_header_compilation`	`Boolean; optional; default is False` Anula --java_header_compilation para inhabilitar la compilación de encabezados en plataformas que no la admiten, p.ej., JDK 7 Bazel.
`genclass`	`List of labels; required` Etiqueta del archivo jar de implementación de GenClass.
`header_compiler`	`List of labels; optional` Etiqueta del compilador de encabezados. Obligatorio si --java_header_compilation está habilitado.
`header_compiler_direct`	`List of labels; optional` Etiqueta opcional del compilador de encabezados para usar en acciones directas de rutas de clase que no incluyen ningún procesador de anotaciones que generen API. Esta herramienta no admite el procesamiento de anotaciones.
`ijar`	`List of labels; required` Etiqueta del ejecutable de ijar.
`jacocorunner`	`Label; optional` Etiqueta del jar de implementación de JacocoCoverageRunner.
`java_runtime`	`Label; required` Es el java_runtime que se debe usar con esta cadena de herramientas. El valor predeterminado es java_runtime en la configuración de ejecución.
`javabuilder`	`List of labels; required` Etiqueta del archivo jar de implementación de JavaBuilder.
`javabuilder_data`	`List of labels; optional` Etiquetas de datos disponibles para la expansión de etiquetas en javabuilder_jvm_opts.
`javabuilder_jvm_opts`	`List of strings; optional` Lista de argumentos para la JVM cuando se invoca JavaBuilder.
`javac_supports_multiplex_workers`	`Boolean; optional; default is True` Es verdadero si JavaBuilder admite la ejecución como un trabajador persistente multiplex y es falso si no lo es.
`javac_supports_workers`	`Boolean; optional; default is True` Es verdadero si JavaBuilder admite la ejecución como un trabajador persistente y es falso si no lo es.
`javacopts`	`List of strings; optional` La lista de argumentos adicionales para el compilador de Java. Consulta la documentación del compilador de Java para obtener la amplia lista de posibles indicadores del compilador de Java.
`jvm_opts`	`List of strings; optional` Lista de argumentos para la JVM cuando se invoca el compilador de Java. Consulta la documentación de máquina virtual de Java a fin de obtener la lista completa de marcas posibles para esta opción.
`oneversion`	`Label; optional` Etiqueta del objeto binario de aplicación de una versión.
`oneversion_whitelist`	`Label; optional` Etiqueta de la lista blanca de una versión.
`package_configuration`	`List of labels; optional` La configuración que se debe aplicar a los grupos de paquetes especificados.
`proguard_allowlister`	`Label; optional; default is @bazel_tools//tools/jdk:proguard_whitelister` Etiqueta de la lista de entidades permitidas de ProGuard.
`resourcejar`	`List of labels; optional` Etiqueta del ejecutable del compilador de jar de recursos.
`singlejar`	`List of labels; required` Etiqueta del archivo jar de implementación de SingleJar.
`source_version`	`String; optional` Es la versión de origen de Java (p.ej., "6" o "7"). Especifica qué conjunto de estructuras de código está permitido en el código fuente de Java.
`target_version`	`String; optional` Es la versión de destino de Java (p.ej., "6" o "7"). Especifica para qué entorno de ejecución de Java se debe compilar la clase.
`timezone_data`	`Label; optional` Etiqueta de un archivo jar de recursos que contiene datos de zona horaria. Si se configura, los datos de zona horaria se agregan como una dependencia implícita de tiempo de ejecución de todas las reglas java_binary.
`tools`	`List of labels; optional` Etiquetas de herramientas disponibles para la expansión de etiquetas en jvm_opts.
`turbine_data`	`List of labels; optional` Etiquetas de datos disponibles para la expansión de etiquetas en turbine_jvm_opts.
`turbine_jvm_opts`	`List of strings; optional` La lista de argumentos para la JVM cuando se invoca la turbina.
`xlint`	`List of strings; optional` La lista de advertencias para agregar o quitar de la lista predeterminada. Lo antecede con un guion para quitarlo. Consulta la documentación de Javac sobre las opciones de -Xlint para obtener más información.