Notas de la versión del complemento de Android para Gradle 8.13

El repositorio de JCenter se convirtió en solo lectura el 31 de marzo de 2021. Para obtener más información, consulta la Actualización del servicio de JCenter.

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 de Android para Gradle (AGP) suele actualizarse junto con Android Studio, tanto el complemento como el resto del sistema Gradle pueden ejecutarse de forma independiente de Android Studio y actualizarse por separado.

En esta página, se explica cómo mantener tus herramientas de Gradle actualizadas y qué incluyen las actualizaciones más 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:

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 8.13.2 del archivo build.gradle.kts:

Kotlin

plugins {
    id("com.android.application") version "8.13.2" apply false
    id("com.android.library") version "8.13.2" apply false
    id("org.jetbrains.kotlin.android") version "2.2.21" apply false
}

Groovy

plugins {
    id 'com.android.application' version '8.13.2' apply false
    id 'com.android.library' version '8.13.2' 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:8.13.+'. 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 complementoVersión mínima de Gradle requerida
8.138.13
8.128.13
8.118.13
8.108.11.1
8.98.11.1
8.88.10.2
8.78.9
8.68.7
8.58.7
8.48.6
8.38.4
8.28.2
8.18.0
8.08.0

Versiones anteriores

Versión del complementoVersión requerida de Gradle
7.47.5
7.37.4
7.27.3.3
7.17.2
7.07.0
4.2.0+6.7.1
4.1.0+6.5+
4.0.0+6.1.1+
3.6.0 - 3.6.45.6.4+
3.5.0 - 3.5.45.4.1+
3.4.0 - 3.4.35.1.1+
3.3.0 - 3.3.34.10.1+
3.2.0 - 3.2.14.6+
3.1.0+4.4+
3.0.0+4.1+
2.3.0+3.3+
2.1.3 - 2.2.32.14.1 - 3.5
2.0.0 - 2.1.22.10 - 2.13
1.5.02.2.1 - 2.13
1.2.0 - 1.3.12.2.1 - 2.9
1.0.0 - 1.1.32.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 8.13 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 8.13

Sin embargo, en algunos casos, esto puede fallar; por ejemplo, si acabas de actualizar el 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 8.13 de Gradle en el archivo gradle-wrapper.properties. 

...
distributionUrl = https\://services.gradle.org/distributions/gradle-8.13-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 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 de 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 del 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 del 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

Cambios en el control de versiones (noviembre de 2020)

Actualizaremos la numeración de versiones del complemento de Android para Gradle (AGP) para que coincida mejor con la herramienta de compilación subyacente de Gradle.

Estos son algunos de los cambios más importantes:

  • El AGP ahora utilizará el control de versiones semántico y los cambios rotundos se aplicarán solo en las versiones principales.

  • Se lanzará una versión principal del AGP al año, que estará alineada con la actualización más importante de Gradle.

  • La versión posterior al AGP 4.2 será 7.0 y requerirá una actualización a Gradle 7.x. Cada lanzamiento importante del AGP requerirá una actualización de versión principal en la herramienta subyacente de Gradle.

  • Las API quedarán obsoletas con aproximadamente un año de anticipación y, al mismo tiempo, se pondrá a disposición una función de reemplazo. Alrededor de un año después, se quitarán las API obsoletas en la próxima actualización importante.

Complemento de Android para Gradle 8.13.2

Compatibilidad con Kotlin 2.3: El complemento de Android para Gradle 8.13.2 usa R8 8.13.19, que admite Kotlin 2.3.

Compatibilidad

El nivel de API máximo que admite el complemento de Android para Gradle 8.13 es el nivel de API 36. A continuación, se incluye otra información sobre la compatibilidad:

Versión mínima Versión predeterminada Notas
Gradle 8.13 8.13 Para obtener más información, consulta cómo actualizar Gradle.
Herramientas de desarrollo del SDK 35.0.0 35.0.0 Instala o configura SDK Build Tools.
NDK N/A 27.0.12077973 Instala o configura una versión diferente del NDK.
JDK 17 17 Para obtener más información, consulta cómo configurar la versión de JDK.

Errores corregidos

Complemento de Android para Gradle 8.13.2

Errores corregidos
Complemento de Android para Gradle
AAPT2 de AGP 8.12.0 requiere SSSE3 y SSE4_1, que no son compatibles con el servidor de compilación de F-Droid.
Reductor (R8)
Compatibilidad con Kotlin 2.3: Se actualizó la biblioteca kotlin-metadata-jvm a la versión 2.2.10.
RemoveVerificationErrorForUnknownReturnedValues puede causar errores de verificación de bloqueo.

Complemento de Android para Gradle 8.13.1

Errores corregidos
Complemento de Android para Gradle
No se resuelven los nuevos IDs de recursos del gráfico de navegación durante la compilación incremental.
compileSdkSpec.minorApiLevel no funciona con SettingsExtension.
Reductor (R8)
La aplicación falla en el tiempo de ejecución con java.lang.VerifyError cuando se usa R8 8.11 y versiones posteriores.
ApiModeling hace que SurfaceTexture falle durante el tiempo de ejecución.
La reducción de recursos optimizada falla con java.lang.StringIndexOutOfBoundsException cuando el nombre de la clase termina con $.
Posible error de tiempo de ejecución: La deduplicación de métodos de R8 y la caché del intérprete de ART provocan una discrepancia en la superclase.
D8 borra el campo utilizado.
AGP 8.13.0: r8 falla con el ERROR: R8: java.lang.NullPointerException: No se puede invocar "Object.getClass()" porque "<local7>" es nulo.
Algunos atributos de SourceFile en r8lib.jar no son correctos.
Las versiones de R8 incluidas en AGP 8.12.0 y versiones posteriores pueden producir un error de memoria insuficiente con Play Billing 8.0.0.
R8 interrumpe las funciones de suspensión intercaladas.
Se creó código ilegal después de la optimización con R8 8.11.18.

Complemento de Android para Gradle 8.13.0

Errores corregidos
Complemento de Android para Gradle
Se ejecuta CheckAarMetadataTask en proyectos de biblioteca cuando se compila un AAR.
El complemento de biblioteca fusionada no puede procesar referencias de recursos desde una biblioteca externa.
El complemento de Fused Library debería permitir el uso de overrideLibrary.
Se cambia el valor predeterminado de targetSdk de la app para que se base en compileSdk y no en minSdk.
`com.android.kotlin.multiplatform.library` falla con dispositivos administrados por Gradle.
Reductor (R8)
Se produce una ClassCastException debido a una clase imposible con R8.
ArrayIndexOutOfBoundsException: El índice 0 está fuera de los límites para la longitud 0 desde la versión 8.10.0.
El análisis de patrones en la API de enableExperimentalPartialShrinking es muy estricto.