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 esta página, se explica cómo mantener tus herramientas de Gradle actualizadas. Para consultar las notas de la versión del complemento de Android para Gradle, visita la página de notas de la versión.
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.kts 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 establece el complemento en la versión 9.0 del archivo build.gradle.kts:
Kotlin
plugins { id("com.android.application") version "9.0" apply false id("com.android.library") version "9.0" apply false id("org.jetbrains.kotlin.android") version "2.2.21" apply false }
Groovy
plugins { id 'com.android.application' version '9.0' apply false id 'com.android.library' version '9.0' apply false id 'org.jetbrains.kotlin.android' version '2.2.21' apply false }
Precaución: No debes usar dependencias dinámicas en los números de versión, como 'com.android.tools.build:gradle:9.+'.
El uso de esta función puede provocar actualizaciones de versión inesperadas y dificultar la resolución de 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 |
|---|---|
| 9.0 | 9.1.0 |
| 8.13 | 8.13 |
| 8.12 | 8.13 |
| 8.11 | 8.13 |
| 8.10 | 8.11.1 |
| 8.9 | 8.11.1 |
| 8.8 | 8.10.2 |
| 8.7 | 8.9 |
| 8.6 | 8.7 |
| 8.5 | 8.7 |
| 8.4 | 8.6 |
| 8.3 | 8.4 |
| 8.2 | 8.2 |
| 8.1 | 8.0 |
| 8.0 | 8.0 |
Versiones anteriores
| Versión del complemento | Versión requerida de Gradle |
|---|---|
| 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 |
| 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 9.1.0 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 9.1.0
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 9.1.0 en el archivo gradle-wrapper.properties.
...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.1.0-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 (AGP) incorpora varias funciones específicas para compilar apps para Android. En la siguiente tabla, se muestra qué versión del AGP se requiere para cada versión de Android Studio.
| Versión de Android Studio | Versión requerida del AGP |
|---|---|
| Actualización de funciones de Otter 3 | 2025.2.3 | 4.0-9.0 |
| Actualización de funciones de Otter 2 | 2025.2.2 | 4.0-8.13 |
| Otter | 2025.2.1 | 4.0-8.13 |
| Actualización de funciones de Narwhal 4 | 2025.1.4 | 4.0-8.13 |
| Actualización de funciones de Narwhal 3 | 2025.1.3 | 4.0-8.13 |
| Actualización de funciones de Narwhal | 2025.1.2 | 4.0-8.12 |
| Narwhal | 2025.1.1 | 3.2-8.11 |
| Actualización de funciones de Meerkat | 2024.3.2 | 3.2-8.10 |
| Meerkat | 2024.3.1 | 3.2-8.9 |
Versiones anteriores
| Versión Android Studio | Versión requerida del AGP |
|---|---|
| Actualización de funciones de Ladybug | 2024.2.2 | 3.2-8.8 |
| Ladybug | 2024.2.1 | 3.2-8.7 |
| Actualización de funciones de Koala | 2024.1.2 | 3.2-8.6 |
| Koala | 2024.1.1 | 3.2-8.5 |
| Jellyfish | 2023.3.1 | 3.2-8.4 |
| Iguana | 2023.2.1 | 3.2-8.3 |
| Hedgehog | 2023.1.1 | 3.2-8.2 |
| 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 |
Para conocer las novedades del complemento de Android para Gradle, consulta las notas de la versión del complemento de Android para Gradle.
Versiones mínimas de herramientas para el nivel de API de Android
Hay versiones mínimas de Android Studio y AGP que admiten un nivel de API específico. El uso de versiones anteriores de Android Studio o AGP que las requeridas por targetSdk o compileSdk de tu proyecto podría generar problemas inesperados. Recomendamos usar la versión preliminar más reciente de Android Studio y AGP para trabajar en proyectos orientados a versiones preliminares del SO Android. Puedes instalar versiones preliminares de Android Studio junto con una versión estable.
Estas son las versiones mínimas de Android Studio y AGP:
| Nivel de API | Versión mínima de Android Studio | Versión mínima del AGP |
|---|---|---|
| 36.1 | Actualización de funciones de Narwhal 3 | 2025.1.3 | 8.13.0 |
| 36.0 | Meerkat | 2024.3.1 Parche 1 | 8.9.1 |
| 35 | Actualización de funciones de Koala | 2024.2.1 | 8.6.0 |
| 34 | Hedgehog | 2023.1.1 | 8.1.1 |
| 33 | Flamingo | 2022.2.1 | 7.2 |