El sistema de compilación de Android Studio se basa en Gradle, y el complemento de Android para Gradle incorpora varias funciones específicas para compilar apps para Android. Si bien el complemento para Android suele actualizarse en el paso de bloqueo con Android Studio, el complemento y el resto del sistema Gradle se pueden ejecutar independientemente de Android Studio y se pueden actualizar por separado.
En esta página, se explica cómo mantener tus herramientas de Gradle actualizadas y cuál es el contenido de las actualizaciones recientes. Para conocer las notas de las versiones anteriores del complemento de Android para Gradle, consulta las notas de las versiones anteriores.
Si quieres obtener un resumen general sobre los próximos cambios rotundos, consulta el plan del complemento de Android para Gradle.
A fin de obtener detalles para configurar tus compilaciones de Android con Gradle, consulta las siguientes páginas:
- Cómo configurar tu compilación
- Referencia del DSL del complemento de Android para Gradle
- Referencia del DSL de Gradle
- Guía del usuario sobre el rendimiento de Gradle
Si quieres obtener más información sobre el sistema de compilación de Gradle, consulta la Guía del usuario de Gradle.
Cómo actualizar el complemento de Android para Gradle
Si actualizas Android Studio, es posible que recibas una solicitud para actualizar automáticamente el complemento de Android para Gradle a la versión más reciente disponible. Puedes aceptar la actualización o especificar manualmente una versión, según los requisitos de compilación del proyecto.
Puedes especificar la versión del complemento en el menú File > Project Structure > Project en Android Studio o en el archivo build.gradle de nivel superior. La versión del complemento se aplica a todos los módulos integrados en ese proyecto de Android Studio. En el siguiente ejemplo, se configura el complemento en la versión 7.4.1 del archivo build.gradle:
Groovy
plugins {
id 'com.android.application' version '7.4.1' apply false
id 'com.android.library' version '7.4.1' apply false
id 'org.jetbrains.kotlin.android' version '1.5.31' apply false
}
Kotlin
plugins {
id("com.android.application") version "7.4.1" apply false
id("com.android.library") version "7.4.1" apply false
id("org.jetbrains.kotlin.android") version "1.5.31" apply false
}
Precaución: No debes usar dependencias dinámicas en los números de versión, como 'com.android.tools.build:gradle:2.+'. El uso de esa función puede causar actualizaciones de versión inesperadas y dificultades para resolver diferencias entre versiones.
Si no se descargó la versión especificada del complemento, Gradle la descargará la próxima vez que compiles el proyecto o hagas clic en Files > Sync Project with Gradle Files en la barra de menú de Android Studio.
Cómo actualizar Gradle
Si actualizas Android Studio, es posible que recibas una solicitud para actualizar también Gradle a la versión más reciente disponible. Puedes aceptar la actualización o especificar manualmente una versión, según los requisitos de compilación del proyecto.
En la siguiente tabla, se muestra qué versión de Gradle se requiere para cada versión del complemento de Android para Gradle. Si quieres obtener el mejor rendimiento, deberías usar la versión más reciente de Gradle y del complemento.
| Versión del complemento | Versión mínima de Gradle requerida |
|---|---|
| 8.1 | 8.0 |
| 8.0 | 8.0 |
| 7.4 | 7.5 |
| 7.3 | 7.4 |
| 7.2 | 7.3.3 |
| 7.1 | 7.2 |
| 7.0 | 7.0 |
| 4.2.0+ | 6.7.1 |
Versiones anteriores
| Versión del complemento | Versión requerida de Gradle |
|---|---|
| 4.1.0+ | 6.5+ |
| 4.0.0+ | 6.1.1+ |
| 3.6.0 - 3.6.4 | 5.6.4+ |
| 3.5.0 - 3.5.4 | 5.4.1+ |
| 3.4.0 - 3.4.3 | 5.1.1+ |
| 3.3.0 - 3.3.3 | 4.10.1+ |
| 3.2.0 - 3.2.1 | 4.6+ |
| 3.1.0+ | 4.4+ |
| 3.0.0+ | 4.1+ |
| 2.3.0+ | 3.3+ |
| 2.1.3 - 2.2.3 | 2.14.1 - 3.5 |
| 2.0.0 - 2.1.2 | 2.10 - 2.13 |
| 1.5.0 | 2.2.1 - 2.13 |
| 1.2.0 - 1.3.1 | 2.2.1 - 2.9 |
| 1.0.0 - 1.1.3 | 2.2.1 - 2.3 |
Puedes especificar la versión de Gradle en el menú File > Project Structure > Project en Android Studio o actualizar tu versión de Gradle con la línea de comandos.
La forma recomendada es usar la herramienta de línea de comandos Gradle Wrapper, que actualiza las secuencias de comandos gradlew. En el siguiente ejemplo, se configura la versión de Gradle en 7.5.1 con Gradle Wrapper.
Ten en cuenta que debes ejecutar este comando dos veces para actualizar tanto Gradle como el wrapper de Gradle (si quieres obtener más información, consulta el artículo para actualizar el wrapper de Gradle).
gradle wrapper --gradle-version 7.5.1
Sin embargo, en algunos casos, esto puede fallar; por ejemplo, si acabas de actualizar AGP y ya no es compatible con la versión actual de Gradle. En este caso, debes editar la referencia a la distribución de Gradle en el archivo gradle/wrapper/gradle-wrapper.properties. En el siguiente ejemplo, se configura la versión de Gradle en 7.5.1 en el archivo gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-7.5.1-bin.zip
...
Compatibilidad del complemento de Android para Gradle y Android Studio
El sistema de compilación de Android Studio se basa en Gradle, y el complemento de Android para Gradle incorpora varias funciones específicas para compilar apps para Android. En la siguiente tabla, se muestra qué versión del complemento de Android para Gradle se requiere en cada versión de Android Studio.
| Versión de Android Studio | Versión de complemento requerida |
|---|---|
| Giraffe | 2022.3.1 | 3.2-8.1 |
| Flamingo | 2022.2.1 | 3.2-8.0 |
| Electric Eel | 2022.1.1 | 3.2-7.4 |
| Dolphin | 2021.3.1 | 3.2-7.3 |
| Chipmunk | 2021.2.1 | 3.2-7.2 |
| Bumblebee | 2021.1.1 | 3.2-7.1 |
| Arctic Fox | 2020.3.1 | 3.1-7.0 |
A fin de conocer las novedades del complemento de Android para Gradle, consulta las notas de la versión del complemento de Android para Gradle.
Cambios en el control de versiones (noviembre de 2020)
Actualizaremos la numeración de versiones del complemento de Android para Gradle (AGP) a fin de que coincida mejor con la herramienta de compilación subyacente de Gradle.
Estos son algunos de los cambios más importantes:
AGP ahora usará el control de versiones semántico y los cambios rotundos se incluirán en las versiones principales.
Se lanzará una versión principal de AGP por año, que estará alineada con la actualización más importante de Gradle.
La versión posterior a AGP 4.2 será 7.0 y requerirá una actualización a Gradle 7.x. Cada lanzamiento importante de AGP requerirá una actualización importante de versión de la herramienta subyacente de Gradle.
Las API quedarán obsoletas aproximadamente con un año de anticipación y, al mismo tiempo, se pondrá a disposición una función de reemplazo. Las APIs obsoletas se quitarán aproximadamente un año después, en la próxima actualización importante.
7.4.0 (diciembre de 2022)
El complemento de Android para Gradle 7.4.0 es una actualización importante que incluye una variedad de nuevas funciones y mejoras.
Compatibilidad
| Versión mínima | Versión predeterminada | Notas | |
|---|---|---|---|
| Gradle | 7.5 | 7.5 | Para obtener más información, consulta cómo actualizar Gradle. |
| Herramientas de desarrollo del SDK | 30.0.3 | 30.0.3 | Instala o configura las herramientas de compilación del SDK. |
| NDK | N/A | 23.1.7779620 | Instala o configura una versión diferente del NDK. |
| JDK | 11 | 11 | Para obtener más información, consulta cómo configurar la versión de JDK. |
Versiones de parches
La siguiente es una lista de las versiones de parche para el complemento de Android para Gradle 7.4.
Complemento de Android para Gradle 7.4.2 (febrero de 2023)
Esta actualización menor incluye las siguientes correcciones de errores:
| Errores corregidos | |
|---|---|
|
DexingFileDependenciesTask.outputKeepRules es un directorio, pero está marcado como OutputFile.
|
|
|
Se produjo un error
AnnotationProcessorOptions.arguments are queried cuando se actualizaba a la versión 7.4 Beta 1. |
|
|
processDebugUnitTestManifest falla con los marcadores de posición del manifiesto para las variantes de prueba.
|
|
Complemento de Android para Gradle 7.4.1 (febrero de 2023)
Esta actualización menor incluye las siguientes correcciones de errores:
| Errores corregidos | |
|---|---|
|
Migración de la propiedad
destination a la propiedad outputLocation para abordar la advertencia de baja y prepararte para Gradle 9.0 |
|
|
AGP 7.4.0-rc01 interrumpe la API de Variant con el mensaje "Querying the mapped value of
map(provider(java.util.Set)) before task '...' has completed is not supported" |
|
Informe posterior a la actualización del Asistente de actualización del AGP y funcionalidad de reversión
El Asistente de actualización del AGP ahora incluye un informe posterior a la actualización. Este informe describe los pasos que se completaron y si la actualización fue exitosa o no. También incluye una acción para revertir los cambios que realizó el Asistente de actualización si hay problemas de compilación o prueba del proyecto después de la actualización.
La importación de proyectos se ejecuta en paralelo
El IDE de Studio ahora importa proyectos en paralelo cuando usas Gradle 7.4.2 o una versión posterior y el complemento de Android para Gradle 7.2.0 o una versión posterior. En particular, cuando Android Studio activa una sincronización de Gradle, la información que describe los proyectos incluidos en tu compilación se crea en paralelo. Esto suele acelerar el proceso de sincronización, en especial para proyectos más grandes. Las comparativas muestran que el tiempo que lleva compilar modelos de Gradle para un proyecto muy grande (con 3,500 subproyectos de Gradle) se reduce en un 50%, de 10 minutos a 5 minutos.
El complemento de Android para Gradle se orienta al código de bytes JVM 11
A partir del complemento de Android para Gradle 7.4.0-alpha04, se envía AGP con el código de bytes JVM 11. Esto significa que, si compilas en AGP o escribes verificaciones personalizadas de lint, debes comenzar a orientar el código de bytes de JVM 11. Una de las formas de hacerlo es incluir lo siguiente en tu archivo build.gradle de nivel de módulo:
sourceCompatibility = "11"
targetCompatibility = "11"