Para obtener documentación sobre versiones estables, usa el menú desplegable "Documentos con versiones". La vista predeterminada refleja la versión más reciente en el encabezado.

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

Reglas de Java

Informar un problema Ver fuente

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 origen de la regla

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”), más 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. Cuando ejecutes la secuencia de comandos de shell del wrapper, cualquier variable de entorno JAVABIN que no esté vacía tendrá prioridad sobre la versión especificada a través de la marca --java_runtime_version de Bazel.

La secuencia de comandos del wrapper acepta varias marcas únicas. Consulta //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt para obtener una lista de marcas configurables y variables de entorno que acepta el wrapper.

Objetivos de salida implícitos

name.jar: Es un archivo de 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 forma explícita).
Si compilas el destino <name>_deploy.jar para tu regla, se creará un archivo jar independiente con un manifiesto que permita 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 buscara la ruta de clase desde la secuencia de comandos del wrapper del objeto binario de principio a fin. Además, 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 de launcher, en lugar de ser un archivo JAR normal, _deploy.jar será un objeto binario nativo. Este contendrá el selector y cualquier dependencia (C++) nativa de tu regla, todo vinculado a 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 contiene el código ejecutable y el 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 de deploy.jar, excepto cuando los archivos jar no tengan un jar de origen que coincida.

No se permite un atributo deps en una regla java_binary sin srcs. Esa 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`	Nombre (obligatorio) Un nombre único para este destino. Se recomienda usar el nombre del archivo fuente que constituye 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`	Lista de etiquetas; el valor predeterminado es `[]` 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`	Lista de etiquetas; el valor predeterminado es `[]` 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, generalmente 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 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 que se genera. No debes enumerar la regla de generación en `deps` porque es una no-op. Los archivos de origen de tipo `.srcjar` se descomprimen y compilan. Esto es ú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 anteriormente, se usarán de la misma manera que se describe para los archivos de origen. Casi siempre se requiere este argumento, 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`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de archivos de datos que se incluirán en un archivo jar de Java. Si se especifican los 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 de directorio estándar de Maven (un directorio "src" seguido de un elemento secundario del directorio "resources"). 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, se puede usar el atributo `resource_strip_prefix` a fin de especificar un directorio alternativo específico para los archivos de recursos. Los recursos pueden ser archivos de origen o generados.
`classpath_resources`	Lista de etiquetas; el valor predeterminado es `[]` NO USAR ESTA OPCIÓN, A MENOS QUE NO HAGA DE OTRA FORMA) Una 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 exactamente como `"myconfig.xml"`. Solo se permite en objetos binarios, no en bibliotecas, debido al peligro de conflictos de espacio de nombres.
`create_executable`	Booleano; no configurable; el valor predeterminado es `True` obsoleta: Usa `java_single_jar` en su lugar.
`deploy_env`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de otros destinos de `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 el 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 `[]` Una lista de líneas que se deben 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`	Lista de cadenas; el valor predeterminado es `[]` Opciones de compilador adicionales para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de la shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones del compilador global.
`jvm_flags`	Lista de cadenas; el valor predeterminado es `[]` 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 asignación de token de shell Bourne. 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 también 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 `"$@"` para que puedas pasar otros argumentos después del nombre de clase. Sin embargo, los argumentos destinados al análisis con la 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`	Etiqueta; el valor predeterminado es `None` Especifica el objeto binario que se usará para ejecutar tu programa Java, en lugar del programa `bin/java` normal que se incluye 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 launcher de JDK normal (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 o algún 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 java_binary. En esta configuración, el vinculador no quita el código no utilizado. Si usas cualquier otro selector, las dependencias nativas (C++) se vinculan estáticamente a un objeto binario llamado `{name}_nativedeps`, en el que `{name}` es el atributo `name` de esta regla java_binary. En este caso, el vinculador quitará cualquier código que crea que no se usa del objeto binario resultante, 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 ese destino `cc_library` especifique `alwayslink = 1`. Cuando se usa cualquier selector que no sea el selector predeterminado de JDK, cambia el formato de salida de `*_deploy.jar`. Consulta los documentos principales de java_binary para obtener más información.
`main_class`	Cadena; el valor predeterminado es `""` 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 que un archivo se pueda ejecutar desde una biblioteca 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 durante el tiempo de ejecución: se la puede compilar mediante esta regla (desde `srcs`) o se puede proporcionar mediante 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`	Lista de etiquetas; el valor predeterminado es `[]` Complementos del compilador de Java para ejecutarse en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cada vez que se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos generados por el complemento se incluirán en el archivo jar resultante de esta regla.
`resource_jars`	Lista de etiquetas; el valor predeterminado es `[]` Obsoleto: En su lugar, usa java_import y deps o runtime_deps.
`resource_strip_prefix`	Cadena; el valor predeterminado es `""` Prefijo de ruta de acceso para 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`. Se produce un error cuando un archivo de recursos no se encuentra en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso del archivo de recursos se determina según 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`	Lista de etiquetas; el valor predeterminado es `[]` Bibliotecas que estarán disponibles para el objeto binario final o 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 indicar 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 tanto en `runtime_deps` como en `deps`.
`stamp`	Número entero; el valor predeterminado es `-1` Si se debe codificar la información de compilación en el objeto binario. Valores posibles: `stamp = 1`: Siempre agrega la información de compilación al objeto binario, incluso en compilaciones de `--nostamp`. Se debe evitar esta configuración, ya que podría finalizar el almacenamiento en caché remoto del objeto binario y cualquier acción descendente que dependa 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`	Booleano; el valor predeterminado es `True` Indica si el objeto binario debe usar un selector personalizado. Si se establece este atributo como falso, se ignorarán el atributo launcher y la marca `--java_launcher` relacionada para este destino.
`use_testrunner`	Booleano; el valor predeterminado es `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 de Java y proporciona la clase de prueba al ejecutor de pruebas como un valor de propiedad del sistema `bazel.test_suite`. Puedes usar esto para anular el comportamiento predeterminado, que consiste en usar el ejecutor de pruebas para las reglas `java_test`, en lugar de usarlo para las reglas `java_binary`. Es poco probable que quieras hacerlo. Un uso es para 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 se debe usar el ejecutor de pruebas como 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 origen de la regla

java_import(name, deps, data, add_exports, add_opens, 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, toolchains, visibility)

Esta regla permite el uso de archivos .jar ya compilados 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`	Nombre (obligatorio) Un nombre único para este destino.
`deps`	Lista de etiquetas; el valor predeterminado es `[]` Es la lista de otras bibliotecas que se vincularán al destino. Consulta java_library.deps.
`data`	Lista de etiquetas; el valor predeterminado es `[]` La lista de archivos que necesita esta regla en el tiempo de ejecución.
`add_exports`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda a la `module` o la `package` determinada. Esto corresponde a las marcas javac y JVM --add-exports=.
`add_opens`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda de manera reflexiva al objeto `module` o `package` determinado. Esto corresponde a las marcas javac y JVM --add-opens=.
`constraints`	Lista de cadenas; el valor predeterminado es `[]` Restricciones adicionales impuestas a esta regla como una biblioteca de Java.
`exports`	Lista de etiquetas; el valor predeterminado es `[]` Destinos que estarán disponibles para los usuarios de esta regla. Consulta java_library.exports.
`jars`	Lista de etiquetas (obligatoria) Es la lista de archivos JAR que se proporciona a los destinos de Java que dependen de este destino.
`neverlink`	Booleano; el valor predeterminado es `False` Usa esta biblioteca solo para la compilación y no durante el tiempo de ejecución. Es útil si el entorno de ejecución proporcionará 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`	Lista de etiquetas; el valor predeterminado es `[]` Archivos que se usarán como especificación de ProGuard Estas 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 incluidos aquí solo deben tener reglas idempotentes, como -dontnote, -dontwarn, assumenosideeffects y reglas que comiencen con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`runtime_deps`	Lista de etiquetas; el valor predeterminado es `[]` Bibliotecas que estarán disponibles para el objeto binario final o prueba solo durante el tiempo de ejecución. Consulta java_library.runtime_deps.
`srcjar`	Etiqueta; el valor predeterminado es `None` Un archivo JAR que contiene el código fuente para los archivos JAR compilados.

java_library

Ver el origen de la regla

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

Esta regla compila y vincula fuentes en un archivo .jar.

Resultados implícitos

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

Argumentos

Atributos
`name`	Nombre (obligatorio) Un nombre único para este destino.
`deps`	Lista de etiquetas; el valor predeterminado es `[]` 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 en tiempo de compilación ni en tiempo de ejecución.
`srcs`	Lista de etiquetas; el valor predeterminado es `[]` 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 el nombre de la regla de generación aquí en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que 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. Los archivos de origen de tipo `.srcjar` se descomprimen y compilan. Esto es ú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 anteriormente, se usarán de la misma manera que se describe para los archivos de origen. Los archivos de origen de tipo `.properties` se tratan como recursos. Se ignorarán todos los demás archivos, siempre que haya al menos un archivo de uno de los tipos de archivo descritos anteriormente. De lo contrario, se genera un error. Este argumento casi siempre es obligatorio, excepto si especificas el argumento `runtime_deps`.
`data`	Lista de etiquetas; el valor predeterminado es `[]` 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`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de archivos de datos que se incluirán en un archivo jar de Java. Los recursos pueden ser archivos de origen o generados. Si se especifican los 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 de directorio estándar de Maven (un directorio "src" seguido de un elemento secundario del directorio "resources"). 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`). Si bien esta heurística no se puede anular, se puede usar el atributo `resource_strip_prefix` a fin de especificar un directorio alternativo específico para los archivos de recursos.
`add_exports`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda a la `module` o la `package` determinada. Esto corresponde a las marcas javac y JVM --add-exports=.
`add_opens`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda de manera reflexiva al objeto `module` o `package` determinado. Esto corresponde a las marcas javac y JVM --add-opens=.
`bootclasspath`	Etiqueta; el valor predeterminado es `None` API restringida, no la uses.
`exported_plugins`	Lista de etiquetas; el valor predeterminado es `[]` Es la lista de `java_plugin` (p.ej., procesadores de anotaciones) para exportar a las 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 esta hubiera declarado explícitamente estas etiquetas en `plugins`.
`exports`	Lista de etiquetas; el valor predeterminado es `[]` Bibliotecas exportadas. Si enumeras las reglas aquí, estarán disponibles para las reglas superiores, como si estas dependieran de forma explícita. Esto no sucede con los `deps` normales (no exportados). Resumen: Una regla X puede acceder al código en 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 debe 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` (B). 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, 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. Volviendo al ejemplo anterior, si B exporta C y quiere usar C también, debe incluirla en su propia `deps`.
`javabuilder_jvm_flags`	Lista de cadenas; el valor predeterminado es `[]` API restringida, no la uses.
`javacopts`	Lista de cadenas; el valor predeterminado es `[]` Opciones de compilador adicionales para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de la shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones del compilador global.
`neverlink`	Booleano; el valor predeterminado es `False` Determina 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 proporcionará 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 de uso preferido es cuando la biblioteca de tiempo de ejecución es idéntica a la biblioteca de compilación. Si la biblioteca del tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que difiera solo en los lugares en los que JLS prohíbe los compiladores que se intercalan (y debe ser así para todas las versiones futuras del JLS).
`plugins`	Lista de etiquetas; el valor predeterminado es `[]` Complementos del compilador de Java para ejecutarse en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cada vez que se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos que genera el complemento se incluirán en el archivo jar resultante de esta regla.
`proguard_specs`	Lista de etiquetas; el valor predeterminado es `[]` Archivos que se usarán como especificación de ProGuard Estas 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 incluidos aquí solo deben tener reglas idempotentes, como -dontnote, -dontwarn, assumenosideeffects y reglas que comiencen con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`resource_strip_prefix`	Cadena; el valor predeterminado es `""` Prefijo de ruta de acceso para 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`. Se produce un error cuando un archivo de recursos no se encuentra en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso del archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos fuente. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.
`runtime_deps`	Lista de etiquetas; el valor predeterminado es `[]` Bibliotecas que estarán disponibles para el objeto binario final o 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 tanto en `runtime_deps` como en `deps`.

java_lite_proto_library

Ver el origen de la regla

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

java_lite_proto_library genera código Java a partir de archivos .proto.

deps debe apuntar a reglas de proto_library.

Ejemplo:


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

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

proto_library(
    name = "bar",
)

Argumentos

Atributos

name

Nombre (obligatorio)

Un nombre único para este destino.

deps

Lista de etiquetas; el valor predeterminado es []

La lista de reglas proto_library para las que se generará código Java.

java_proto_library

Ver el origen de la regla

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

java_proto_library genera código Java a partir de archivos .proto.

deps debe apuntar a reglas de proto_library.

Ejemplo:


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

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

proto_library(
    name = "foo_proto",
)

Argumentos

Atributos

name

Nombre (obligatorio)

Un nombre único para este destino.

deps

Lista de etiquetas; el valor predeterminado es []

La lista de reglas proto_library para las que se generará código Java.

java_test

Ver el origen de la regla

java_test(name, deps, srcs, data, resources, add_exports, add_opens, args, bootclasspath, 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, neverlink, plugins, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, use_testrunner, visibility)

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

Objetivos de salida implícitos

name.jar: Es un archivo de Java.
name_deploy.jar: Es un archivo Java adecuado para la implementación. (Solo se compila si se solicita explícitamente). Consulta la descripción de la salida name_deploy.jar de java_binary para obtener más detalles.

Consulta la sección sobre los argumentos java_binary(). 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`	Nombre (obligatorio) Un nombre único para este destino.
`deps`	Lista de etiquetas; el valor predeterminado es `[]` 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`	Lista de etiquetas; el valor predeterminado es `[]` 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 el nombre de la regla de generación aquí en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que 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. Los archivos de origen de tipo `.srcjar` se descomprimen y compilan. Esto es ú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 anteriormente, se usarán de la misma manera que se describe para los archivos de origen. Casi siempre se requiere este argumento, 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`	Lista de etiquetas; el valor predeterminado es `[]` 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.
`resources`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de archivos de datos que se incluirán en un archivo jar de Java. Los recursos pueden ser archivos de origen o generados. Si se especifican los 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 de directorio estándar de Maven (un directorio "src" seguido de un elemento secundario del directorio "resources"). 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`). Si bien esta heurística no se puede anular, se puede usar el atributo `resource_strip_prefix` a fin de especificar un directorio alternativo específico para los archivos de recursos.
`add_exports`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda a la `module` o la `package` determinada. Esto corresponde a las marcas javac y JVM --add-exports=.
`add_opens`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda de manera reflexiva al objeto `module` o `package` determinado. Esto corresponde a las marcas javac y JVM --add-opens=.
`bootclasspath`	Etiqueta; el valor predeterminado es `None` API restringida, no la uses.
`classpath_resources`	Lista de etiquetas; el valor predeterminado es `[]` NO USAR ESTA OPCIÓN, A MENOS QUE NO HAGA DE OTRA FORMA) Una 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 exactamente como `"myconfig.xml"`. Solo se permite en objetos binarios, no en bibliotecas, debido al peligro de conflictos de espacio de nombres.
`create_executable`	Booleano; el valor predeterminado es `True` obsoleta: Usa `java_single_jar` en su lugar.
`deploy_manifest_lines`	Lista de cadenas; el valor predeterminado es `[]` Una lista de líneas que se deben 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`	Lista de cadenas; el valor predeterminado es `[]` Opciones adicionales de compilador para este objeto binario. Sujeto a la sustitución "Make variable" y la tokenización de la shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones del compilador global.
`jvm_flags`	Lista de cadenas; el valor predeterminado es `[]` 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 asignación de token de shell Bourne. 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, 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 con la 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 la clase. Ten en cuenta que este atributo no tiene efecto en los resultados de `*_deploy.jar`.
`launcher`	Etiqueta; el valor predeterminado es `None` Especifica el objeto binario que se usará para ejecutar tu programa Java, en lugar del programa `bin/java` normal que se incluye con el JDK. El destino debe ser un `cc_binary`. Cualquier `cc_binary` que implemente la API de Java Invocation se puede especificar como un valor para este atributo. De forma predeterminada, Bazel usará el launcher de JDK normal (bin/java o java.exe). La marca de Bazel `--java_launcher` relacionada afecta solo a esos 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 o algún 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 java_binary. En esta configuración, el vinculador no quita el código no utilizado. Si usas cualquier otro selector, las dependencias nativas (C++) se vinculan de forma estática a un objeto binario llamado `{name}_nativedeps`, en el que `{name}` es el atributo `name` de esta regla java_binary. En este caso, el vinculador quitará cualquier código que considere que no se usa del objeto binario resultante, 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, cambia el formato del resultado de `*_deploy.jar`. Consulta los documentos principales de java_binary para obtener más información.
`main_class`	Cadena; el valor predeterminado es `""` 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 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 la puede compilar mediante esta regla (desde `srcs`) o se la puede proporcionar mediante 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.
`neverlink`	Booleano; el valor predeterminado es `False`
`plugins`	Lista de etiquetas; el valor predeterminado es `[]` Complementos del compilador de Java para ejecutarse en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cada vez que se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos que genera el complemento se incluirán en el archivo jar resultante de esta regla.
`resource_strip_prefix`	Cadena; el valor predeterminado es `""` Prefijo de ruta de acceso para 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`. Se produce un error cuando un archivo de recursos no se encuentra en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso del archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos fuente. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.
`runtime_deps`	Lista de etiquetas; el valor predeterminado es `[]` Bibliotecas que estarán disponibles para el objeto binario final o 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 tanto en `runtime_deps` como en `deps`.
`stamp`	Número entero; el valor predeterminado es `0` Si se debe codificar la información de compilación en el objeto binario. Valores posibles: `stamp = 1`: Siempre agrega la información de compilación al objeto binario, incluso en compilaciones de `--nostamp`. Se debe evitar esta configuración, ya que podría finalizar el almacenamiento en caché remoto del objeto binario y cualquier acción descendente que dependa 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`	Cadena; el valor predeterminado es `""` Es la clase de 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 se utilice como resguardo en el primer argumento. Este atributo especifica el nombre de una clase de Java que ejecutará esta prueba. Es poco frecuente tener que configurar esto. Si se omite este argumento, se inferirá con el `name` de destino y su ruta relativa de raíz de origen. 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`). Para JUnit4, la clase debe tener una anotación con `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 pruebas. Este atributo también habilita el uso de pruebas de Java fuera del árbol `javatests`.
`use_launcher`	Booleano; el valor predeterminado es `True` Indica si el objeto binario debe usar un selector personalizado. Si se establece este atributo como falso, se ignorarán el atributo launcher y la marca relacionada `--java_launcher` para este destino.
`use_testrunner`	Booleano; el valor predeterminado es `True` Usa la clase del ejecutor de pruebas (de forma predeterminada, `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 propiedad del sistema `bazel.test_suite`. Puedes usar esto para anular el comportamiento predeterminado, que consiste en usar el ejecutor de pruebas para las reglas `java_test`, en lugar de usarlo para las reglas `java_binary`. Es poco probable que quieras hacerlo. Un uso es para las reglas `AllTest` que invoca otra regla (por ejemplo, para configurar una base de datos antes de ejecutar las pruebas). La regla `AllTest` debe declararse como `java_binary`, pero aún debe usar 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 origen de la regla

java_package_configuration(name, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, javacopts, output_licenses, packages, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

Es la 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`	Nombre (obligatorio) Un nombre único para este destino.
`data`	Lista de etiquetas; el valor predeterminado es `[]` La lista de archivos que necesita esta configuración en el entorno de ejecución.
`javacopts`	Lista de cadenas; el valor predeterminado es `[]` Marcas del compilador de Java.
`output_licenses`	Lista de cadenas; el valor predeterminado es `[]`
`packages`	Lista de etiquetas; el valor predeterminado es `[]` El conjunto de `package_group` al que se debe aplicar la configuración.

java_plugin

Ver el origen de la regla

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

java_plugin define complementos para el compilador de Java que ejecuta Bazel. Por el momento, los únicos complementos admitidos 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 de Java.

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

Argumentos

Atributos
`name`	Nombre (obligatorio) Un nombre único para este destino.
`deps`	Lista de etiquetas; el valor predeterminado es `[]` 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 en tiempo de compilación ni en tiempo de ejecución.
`srcs`	Lista de etiquetas; el valor predeterminado es `[]` 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 el nombre de la regla de generación aquí en lugar del nombre del archivo en sí. Esto no solo mejora la legibilidad, sino que 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. Los archivos de origen de tipo `.srcjar` se descomprimen y compilan. Esto es ú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 anteriormente, se usarán de la misma manera que se describe para los archivos de origen. Los archivos de origen de tipo `.properties` se tratan como recursos. Se ignorarán todos los demás archivos, siempre que haya al menos un archivo de uno de los tipos de archivo descritos anteriormente. De lo contrario, se genera un error. Este argumento casi siempre es obligatorio, excepto si especificas el argumento `runtime_deps`.
`data`	Lista de etiquetas; el valor predeterminado es `[]` 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`	Lista de etiquetas; el valor predeterminado es `[]` Una lista de archivos de datos que se incluirán en un archivo jar de Java. Los recursos pueden ser archivos de origen o generados. Si se especifican los 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 de directorio estándar de Maven (un directorio "src" seguido de un elemento secundario del directorio "resources"). 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`). Si bien esta heurística no se puede anular, se puede usar el atributo `resource_strip_prefix` a fin de especificar un directorio alternativo específico para los archivos de recursos.
`add_exports`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda a la `module` o la `package` determinada. Esto corresponde a las marcas javac y JVM --add-exports=.
`add_opens`	Lista de cadenas; el valor predeterminado es `[]` Permite que esta biblioteca acceda de manera reflexiva al objeto `module` o `package` determinado. Esto corresponde a las marcas javac y JVM --add-opens=.
`bootclasspath`	Etiqueta; el valor predeterminado es `None` API restringida, no la uses.
`generates_api`	Booleano; el valor predeterminado es `False` Este atributo marca los procesadores de anotaciones que generan código de API. Si una regla usa un procesador de anotaciones que genera 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é habilitado. ADVERTENCIA: Este atributo afecta el rendimiento de la compilación. Úsalo solo si es necesario.
`javabuilder_jvm_flags`	Lista de cadenas; el valor predeterminado es `[]` API restringida, no la uses.
`javacopts`	Lista de cadenas; el valor predeterminado es `[]` Opciones de compilador adicionales para esta biblioteca. Sujeto a la sustitución "Make variable" y la tokenización de la shell Bourne. Estas opciones del compilador se pasan a javac después de las opciones del compilador global.
`neverlink`	Booleano; el valor predeterminado es `False` Determina 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 proporcionará 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 de uso preferido es cuando la biblioteca de tiempo de ejecución es idéntica a la biblioteca de compilación. Si la biblioteca del tiempo de ejecución difiere de la biblioteca de compilación, debes asegurarte de que difiera solo en los lugares en los que JLS prohíbe los compiladores que se intercalan (y debe ser así para todas las versiones futuras del JLS).
`output_licenses`	Lista de cadenas; el valor predeterminado es `[]`
`plugins`	Lista de etiquetas; el valor predeterminado es `[]` Complementos del compilador de Java para ejecutarse en el tiempo de compilación. Cada `java_plugin` especificado en este atributo se ejecutará cada vez que se compile esta regla. Una biblioteca también puede heredar complementos de dependencias que usan `exported_plugins`. Los recursos que genera el complemento se incluirán en el archivo jar resultante de esta regla.
`processor_class`	Cadena; el valor predeterminado es `""` 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á a un procesador de anotaciones al procesamiento de anotaciones del compilador de Java, pero su ruta de clase del entorno de ejecución se incluirá en la ruta del procesador de anotaciones del compilador. (esto está diseñado 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`	Lista de etiquetas; el valor predeterminado es `[]` Archivos que se usarán como especificación de ProGuard Estas 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 incluidos aquí solo deben tener reglas idempotentes, como -dontnote, -dontwarn, assumenosideeffects y reglas que comiencen con -keep. Otras opciones solo pueden aparecer en proguard_specs de `android_binary` para garantizar combinaciones no tautológicas.
`resource_strip_prefix`	Cadena; el valor predeterminado es `""` Prefijo de ruta de acceso para 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`. Se produce un error cuando un archivo de recursos no se encuentra en este directorio. Si no se especifica (opción predeterminada), la ruta de acceso del archivo de recursos se determina de acuerdo con la misma lógica que el paquete Java de los archivos fuente. Por ejemplo, un archivo de origen en `stuff/java/foo/bar/a.txt` se ubicará en `foo/bar/a.txt`.

java_runtime

Ver el origen de la regla

java_runtime(name, srcs, compatible_with, default_cds, deprecation, distribs, exec_compatible_with, exec_properties, features, hermetic_srcs, hermetic_static_libs, java, java_home, lib_ct_sym, lib_modules, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, version, visibility)

Especifica la configuración de un entorno de ejecución de Java.

Ejemplo:



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

Argumentos

Atributos
`name`	Nombre (obligatorio) Un nombre único para este destino.
`srcs`	Lista de etiquetas; el valor predeterminado es `[]` Todos los archivos del entorno de ejecución.
`default_cds`	Etiqueta; el valor predeterminado es `None` Archivo de CDS predeterminado para `java_runtime` hermético. Cuando la hermética está habilitada para un destino `java_binary` y si este no proporciona su propio archivo de 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 `[]` Archivos en el entorno de ejecución necesarios para implementaciones herméticas.
`hermetic_static_libs`	Lista de etiquetas; el valor predeterminado es `[]` Las bibliotecas que están vinculadas de forma estática al selector para implementaciones herméticas
`java`	Etiqueta; el valor predeterminado es `None` Es la ruta de acceso al archivo ejecutable de Java.
`java_home`	Cadena; el valor predeterminado es `""` 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_ct_sym`	Etiqueta; el valor predeterminado es `None` El archivo lib/ct.sym necesario para la compilación con `--release`. Si no se especifica y hay exactamente un archivo en `srcs` cuya ruta termina en `/lib/ct.sym`, se usa ese archivo.
`lib_modules`	Etiqueta; el valor predeterminado es `None` El archivo lib/modules necesario para implementaciones herméticas.
`output_licenses`	Lista de cadenas; el valor predeterminado es `[]`
`version`	Número entero; el valor predeterminado es `0` La versión de función del entorno de ejecución de Java. Es decir, el número entero que muestra `Runtime.version().feature()`.

java_toolchain

Ver el origen de la regla

java_toolchain(name, android_lint_data, android_lint_jvm_opts, android_lint_opts, android_lint_package_configuration, android_lint_runner, bootclasspath, compatible_javacopts, compatible_with, deprecation, deps_checker, distribs, exec_compatible_with, exec_properties, features, forcibly_disable_header_compilation, genclass, header_compiler, header_compiler_builtin_processors, header_compiler_direct, ijar, jacocorunner, java_runtime, javabuilder, javabuilder_data, javabuilder_jvm_opts, javac_supports_multiplex_workers, javac_supports_worker_cancellation, javac_supports_worker_multiplex_sandboxing, javac_supports_workers, javacopts, jspecify_implicit_deps, jspecify_javacopts, jspecify_packages, jspecify_processor, jspecify_processor_class, jspecify_stubs, jvm_opts, licenses, misc, oneversion, oneversion_allowlist_for_tests, oneversion_whitelist, package_configuration, proguard_allowlister, reduced_classpath_incompatible_processors, restricted_to, singlejar, source_version, tags, target_compatible_with, target_version, testonly, timezone_data, toolchains, tools, turbine_data, turbine_jvm_opts, visibility, xlint)

Especifica la configuración del compilador de 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 quieras ajustar el compilador de Java.

Ejemplos

Un ejemplo sencillo sería el siguiente:



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

Argumentos

Atributos
`name`	Nombre (obligatorio) Un nombre único para este destino.
`android_lint_data`	Lista de etiquetas; el valor predeterminado es `[]` Etiquetas de herramientas disponibles para la expansión de etiquetas en android_lint_jvm_opts.
`android_lint_jvm_opts`	Lista de cadenas; el valor predeterminado es `[]` Lista de argumentos para la JVM cuando se invoca Android Lint.
`android_lint_opts`	Lista de cadenas; el valor predeterminado es `[]` La lista de argumentos de Android Lint
`android_lint_package_configuration`	Lista de etiquetas; el valor predeterminado es `[]` Configuración de Android Lint que se debe aplicar a los grupos de paquetes especificados.
`android_lint_runner`	Etiqueta; el valor predeterminado es `None` Etiqueta del ejecutor de Android Lint, si corresponde.
`bootclasspath`	Lista de etiquetas; el valor predeterminado es `[]` Las entradas de bootclasspath de destino de Java. Corresponde a la marca -bootclasspath de javac.
`compatible_javacopts`	null; default is `{}` API interna; no la uses.
`deps_checker`	Etiqueta; el valor predeterminado es `None` Etiqueta del archivo jar de implementación de ImportDepsChecker.
`forcibly_disable_header_compilation`	Booleano; el valor predeterminado es `False` Anula --java_header_compilation para inhabilitar la compilación de encabezados en plataformas que no la admiten, p.ej., JDK 7 Bazel.
`genclass`	Etiqueta; el valor predeterminado es `None` Etiqueta del archivo jar de implementación de GenClass.
`header_compiler`	Etiqueta; el valor predeterminado es `None` Etiqueta del compilador de encabezados. Es obligatorio si la dirección --java_header_compilation está habilitada.
`header_compiler_builtin_processors`	Lista de cadenas; el valor predeterminado es `[]` API interna; no la uses.
`header_compiler_direct`	Etiqueta; el valor predeterminado es `None` Etiqueta opcional del compilador de encabezados que se debe usar para acciones directas de ruta de clase que no incluyen ningún procesador de anotaciones que genere API. Esta herramienta no admite el procesamiento de anotaciones.
`ijar`	Etiqueta; el valor predeterminado es `None` Etiqueta del ejecutable ijar.
`jacocorunner`	Etiqueta; el valor predeterminado es `None` Etiqueta del jar de implementación de JacocoCoverageRunner.
`java_runtime`	Etiqueta; el valor predeterminado es `None` 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`	Etiqueta; el valor predeterminado es `None` Etiqueta del archivo jar de implementación de JavaBuilder.
`javabuilder_data`	Lista de etiquetas; el valor predeterminado es `[]` Etiquetas de datos disponibles para la expansión de etiquetas en javabuilder_jvm_opts.
`javabuilder_jvm_opts`	Lista de cadenas; el valor predeterminado es `[]` Es la lista de argumentos para la JVM cuando se invoca JavaBuilder.
`javac_supports_multiplex_workers`	Booleano; el valor predeterminado es `True` Es verdadero si JavaBuilder admite la ejecución como un trabajador persistente multiplex y falso si no lo hace.
`javac_supports_worker_cancellation`	Booleano; el valor predeterminado es `True` Es verdadero si JavaBuilder admite la cancelación de trabajadores persistentes; es falso si no lo hace.
`javac_supports_worker_multiplex_sandboxing`	Booleano; el valor predeterminado es `False` Es verdadero si JavaBuilder admite la ejecución como un trabajador persistente multiplex con zona de pruebas. Si no lo hace, es falso.
`javac_supports_workers`	Booleano; el valor predeterminado es `True` Es verdadero si JavaBuilder admite la ejecución como un trabajador persistente y falso si no lo hace.
`javacopts`	Lista de cadenas; el valor predeterminado es `[]` La lista de argumentos adicionales para el compilador de Java. Consulta la documentación del compilador de Java para obtener una lista completa de posibles marcas del compilador de Java.
`jspecify_implicit_deps`	Etiqueta; el valor predeterminado es `None` Experimental, no usar
`jspecify_javacopts`	Lista de cadenas; el valor predeterminado es `[]` Experimental, no usar
`jspecify_packages`	Lista de etiquetas; el valor predeterminado es `[]` Experimental, no usar
`jspecify_processor`	Etiqueta; el valor predeterminado es `None` Experimental, no usar
`jspecify_processor_class`	Cadena; el valor predeterminado es `""` Experimental, no usar
`jspecify_stubs`	Lista de etiquetas; el valor predeterminado es `[]` Experimental, no usar
`jvm_opts`	Lista de cadenas; el valor predeterminado es `[]` Es la lista de argumentos para la JVM cuando se invoca el compilador de Java. Consulta la documentación de las máquinas virtuales de Java para obtener la lista extensa de marcas posibles para esta opción.
`misc`	Lista de cadenas; el valor predeterminado es `[]` Obsoleto: usa javacopts en su lugar
`oneversion`	Etiqueta; el valor predeterminado es `None` Etiqueta del objeto binario de aplicación de una versión.
`oneversion_allowlist_for_tests`	Etiqueta; el valor predeterminado es `None` Etiqueta de la lista de entidades permitidas de una versión para pruebas.
`oneversion_whitelist`	Etiqueta; el valor predeterminado es `None` Etiqueta de la lista de entidades permitidas de una versión.
`package_configuration`	Lista de etiquetas; el valor predeterminado es `[]` Es la configuración que se debe aplicar a los grupos de paquetes especificados.
`proguard_allowlister`	Etiqueta; el valor predeterminado es `"@bazel_tools//tools/jdk:proguard_whitelister"` Etiqueta de la lista de entidades permitidas de Proguard.
`reduced_classpath_incompatible_processors`	Lista de cadenas; el valor predeterminado es `[]` API interna; no la uses.
`singlejar`	Etiqueta; el valor predeterminado es `None` Etiqueta del archivo jar de implementación de SingleJar.
`source_version`	Cadena; el valor predeterminado es `""` 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`	Cadena; el valor predeterminado 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`	Etiqueta; el valor predeterminado es `None` Etiqueta de un archivo jar de recursos que contiene datos de zona horaria. Si se configura, los datos de la zona horaria se agregan como una dependencia implícita de tiempo de ejecución de todas las reglas java_binary.
`tools`	Lista de etiquetas; el valor predeterminado es `[]` Etiquetas de herramientas disponibles para la expansión de etiquetas en jvm_opts.
`turbine_data`	Lista de etiquetas; el valor predeterminado es `[]` Etiquetas de datos disponibles para la expansión de etiquetas en turbine_jvm_opts.
`turbine_jvm_opts`	Lista de cadenas; el valor predeterminado es `[]` La lista de argumentos para la JVM cuando se invoca la turbina.
`xlint`	Lista de cadenas; el valor predeterminado es `[]` Es 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.