Ya sea que tu código fuente esté escrito en Java, Kotlin o ambos, existen varios lugares en los que debes elegir una versión de lenguaje JDK o Java para tu compilación.
Glosario
- Java Development Kit (JDK)
-
El kit de desarrollo de Java (JDK) contiene lo siguiente:
- Herramientas, como compilador, generador de perfiles y creador de archivos. Estos se usan en segundo plano durante la compilación para crear la aplicación.
- Bibliotecas con APIs a las que puedes llamar desde el código fuente de Kotlin o Java. Ten en cuenta que no todas las funciones están disponibles en Android.
- Java Virtual Machine (JVM), un intérprete que ejecuta aplicaciones de Java. Usa la JVM para ejecutar el IDE de Android Studio y la herramienta de compilación de Gradle. La JVM no se usa en dispositivos ni emuladores de Android.
- Entorno de ejecución de JetBrains (JBR)
- JetBrains Runtime (JBR) es un JDK mejorado que se distribuye con Android Studio. Incluye varias optimizaciones para usar en Studio y productos JetBrains relacionados, pero también se puede usar para ejecutar otras aplicaciones de Java.
¿Cómo elijo un JDK para ejecutar Android Studio?
Te recomendamos que uses el JBR para ejecutar Android Studio. Se implementa con Android Studio y se usa para probarlo, e incluye mejoras para un uso óptimo de Android Studio. Para garantizar esto, no configures la variable de entorno STUDIO_JDK
.
Las secuencias de comandos de inicio para Android Studio buscan una JVM en el siguiente orden:
- Variable de entorno
STUDIO_JDK
- Directorio
studio.jdk
(en la distribución de Android Studio) - Directorio
jbr
(JetBrains Runtime), en la distribución de Android Studio Es la opción recomendada. - Variable de entorno
JDK_HOME
- Variable de entorno
JAVA_HOME
- Se puede ejecutar
java
en la variable de entornoPATH
¿Cómo elijo el JDK que ejecuta mis compilaciones de Gradle?
Si ejecutas Gradle con los botones de Android Studio, el JDK establecido en la configuración de Android Studio se usa para ejecutar Gradle. Si ejecutas Gradle en una terminal, dentro o fuera de Android Studio, la variable de entorno JAVA_HOME
(si está configurada) determina qué JDK ejecuta las secuencias de comandos de Gradle. Si JAVA_HOME
no está configurado, usa el comando java
en tu variable de entorno PATH
.
Para obtener resultados más coherentes, asegúrate de establecer la variable de entorno JAVA_HOME
y la configuración del JDK de Gradle en Android Studio con ese mismo JDK.
Cuando se ejecuta tu compilación, Gradle crea un proceso llamado daemon para realizar la compilación. Este proceso se puede volver a usar, siempre que las compilaciones usen la misma versión de JDK y Gradle. Volver a usar un daemon reduce el tiempo necesario para iniciar una JVM nueva y, luego, inicializar el sistema de compilación.
Si comienzas a usar diferentes versiones de JDK o Gradle, se crearán daemons adicionales, lo que consumirá más CPU y memoria.
Configuración de Gradle JDK en Android Studio
Para modificar la configuración de Gradle JDK del proyecto existente, abre la configuración de Gradle desde File (o Android Studio en macOS) > Settings > Build, Execution, Deployment > Build Tools > Gradle. El menú desplegable Gradle JDK contiene las siguientes opciones para seleccionar:
- Macros como
JAVA_HOME
yGRADLE_LOCAL_JAVA_HOME
- Las entradas de la tabla de JDK en formato
vendor-version
, comojbr-17
, que se almacenan en los archivos de configuración de Android - Cómo descargar un JDK
- Agrega un JDK específico
- JDK detectados de forma local en el directorio de instalación predeterminado de JDK del sistema operativo
La opción seleccionada se almacena en la opción gradleJvm
en el archivo .idea/gradle.xml
del proyecto, y su resolución de ruta de JDK se usa para ejecutar Gradle cuando se inicia a través de Android Studio.
![](https://developer.android.google.cn/static/images/tools/as-gradle-jdk.png?authuser=9&hl=es)
Las macros permiten la selección dinámica de la ruta de acceso del JDK del proyecto:
JAVA_HOME
: Usa la variable de entorno con el mismo nombre.GRADLE_LOCAL_JAVA_HOME
: Usa la propiedadjava.home
en el archivo.gradle/config.properties
, que se establece de forma predeterminada en el entorno de ejecución de JetBrains.
El JDK seleccionado se usa para ejecutar tu compilación de Gradle y resolver las referencias de la API de JDK cuando editas las secuencias de comandos de compilación y el código fuente. Ten en cuenta que el compileSdk
especificado restringirá aún más los símbolos de Java disponibles cuando edites y compiles el código fuente.
Asegúrate de elegir una versión de JDK que sea superior o igual a las versiones de JDK que usan los complementos que usas en tu compilación de Gradle. Para determinar la versión mínima requerida de JDK para el complemento de Android para Gradle (AGP), consulta la tabla de compatibilidad en las notas de la versión.
Por ejemplo, la versión 8.x del complemento de Android para Gradle requiere JDK 17. Si intentas ejecutar una compilación de Gradle que la usa con una versión anterior del JDK, se mostrará el siguiente mensaje:
An exception occurred applying plugin request [id: 'com.android.application']
> Failed to apply plugin 'com.android.internal.application'.
> Android Gradle plugin requires Java 17 to run. You are currently using Java 11.
Your current JDK is located in /usr/local/buildtools/java/jdk11
You can try some of the following options:
- changing the IDE settings.
- changing the JAVA_HOME environment variable.
- changing `org.gradle.java.home` in `gradle.properties`.
¿Qué APIs de Java puedo usar en mi código fuente de Java o Kotlin?
Una aplicación para Android puede usar algunas de las APIs definidas en un JDK, pero no todas. El SDK de Android define implementaciones de muchas funciones de la biblioteca de Java como parte de las APIs disponibles. La propiedad compileSdk
especifica qué versión del SDK de Android usar cuando se compila el código fuente de Kotlin o Java.
Kotlin
android {
...
compileSdk = 33
}
Groovy
android {
...
compileSdk 33
}
Cada versión de Android admite una versión específica del JDK y un subconjunto de sus APIs de Java disponibles. Si usas una API de Java que está disponible en un compileSdk
que no está disponible en el minSdk
especificado, es posible que puedas usar la API en la versión anterior de Android con un proceso conocido como expansión de sintaxis.
Consulta las APIs de Java 11 y versiones posteriores disponibles con la expansión de sintaxis para conocer las APIs compatibles.
Usa esta tabla para determinar qué versión de Java es compatible con cada API de Android y dónde encontrar detalles sobre las APIs de Java disponibles.
Android | Java | Funciones de API y de lenguaje compatibles |
---|---|---|
14 (API 34) | 17 | Bibliotecas principales |
13 (API 33) | 11 | Bibliotecas principales |
12 (nivel de API 32) | 11 | API de Java |
11 y versiones anteriores | Versiones de Android |
¿Qué JDK compila mi código fuente de Java?
El JDK de la cadena de herramientas de Java contiene el compilador de Java que se usa para compilar cualquier código fuente de Java. Este JDK también ejecuta pruebas de unidades y javadoc durante la compilación.
La cadena de herramientas usa de forma predeterminada el JDK que se usa para ejecutar Gradle. Si usas la configuración predeterminada y ejecutas una compilación en diferentes máquinas (por ejemplo, tu máquina local y un servidor de integración continua independiente), los resultados de la compilación pueden diferir si se usan diferentes versiones de JDK.
Para crear una compilación más coherente, puedes especificar de forma explícita una versión de la cadena de herramientas de Java. Especifica esto:
- Ubica un JDK compatible en el sistema que ejecuta la compilación.
- Si no existe un JDK compatible (y se define un agente de resolución de la cadena de herramientas), descarga uno.
- Expone las APIs de Java del conjunto de herramientas para llamadas desde el código fuente.
- Compila el código fuente Java con la versión de lenguaje Java.
- Proporciona valores predeterminados para
sourceCompatibility
ytargetCompatibility
.
Te recomendamos que siempre especifiques la cadena de herramientas de Java y que te asegures de que el JDK especificado esté instalado o que agregues un agente de resolución de la cadena de herramientas a tu compilación.
Puedes especificar la cadena de herramientas si tu código fuente está escrito en Java, Kotlin o ambos. Especifica la cadena de herramientas en el nivel superior del archivo build.gradle(.kts)
de tu módulo.
Especifica la versión de la cadena de herramientas de Java de la siguiente manera:
Kotlin
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
Groovy
java {
toolchain {
languageVersion = JavaLanguageVersion.of(17)
}
}
Esto funciona si tu fuente es Kotlin, Java o una combinación de ambos.
La versión del JDK de la cadena de herramientas puede ser la misma que el JDK que se usó para ejecutar Gradle, pero ten en cuenta que tienen diferentes propósitos.
¿Qué funciones de la fuente del lenguaje Java puedo usar en mi código fuente de Java?
La propiedad sourceCompatibility
determina qué funciones del lenguaje Java están disponibles durante la compilación del código fuente de Java.
No afecta al código fuente de Kotlin.
Si no se especifica, el valor predeterminado es la cadena de herramientas de Java o el JDK que se usa para ejecutar Gradle. Te recomendamos que siempre especifiques de forma explícita
una cadena de herramientas (opción preferida) o sourceCompatibility
.
Especifica sourceCompatibility
en el archivo build.gradle(.kts)
de tu módulo.
Kotlin
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
}
}
Groovy
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
}
}
¿Qué funciones binarias de Java se pueden usar cuando compilo mi fuente de Kotlin o Java?
La especificación de targetCompatibility
y jvmTarget
determina la versión de formato de clase de Java que se usa cuando se genera el código de bytes para la fuente compilada de Java y Kotlin, respectivamente.
Algunas funciones de Kotlin existían antes de que se agregaran funciones equivalentes de Java.
Los primeros compiladores de Kotlin tuvieron que crear su propia manera de representar esas funciones de Kotlin. Algunas de estas funciones se agregaron posteriormente a Java.
Con niveles posteriores de jvmTarget
, el compilador de Kotlin podría usar directamente la función Java, lo que podría generar un mejor rendimiento.
targetCompatibility
tiene el mismo valor predeterminado que sourceCompatibility
, pero, si se especifica, debe ser mayor o igual que sourceCompatibility
.
jvmTarget
usa de forma predeterminada la versión de la cadena de herramientas.
Las diferentes versiones de Android admiten diferentes versiones de Java. Para aprovechar las funciones adicionales de Java, aumenta targetCompatibility
y jvmTarget
, pero esto podría obligarte a aumentar también tu versión mínima del SDK de Android para asegurarte de que la función esté disponible.
Kotlin
android {
compileOptions {
targetCompatibility = JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget = "17"
}
}
Groovy
android {
compileOptions {
targetCompatibility JavaVersion.VERSION_17
}
kotlinOptions {
jvmTarget '17'
}
}