Cronograma de migración del DSL y la API del complemento de Android para Gradle

El complemento de Android para Gradle (AGP) es el sistema de compilación compatible con aplicaciones para Android. Además, admite la compilación de muchos tipos diferentes de fuentes y su vinculación a una aplicación que puedes ejecutar en un dispositivo Android físico o en un emulador.

En la siguiente sección, se describe la evolución planificada del DSL y la API del AGP. A medida que se incorporen nuevas API en versiones estables, las API anteriores se marcarán como obsoletas. Esas API obsoletas dejarán de estar disponibles en la próxima versión estable. A continuación, encontrarás información sobre los próximos cambios en cada versión importante del AGP.

Para obtener un registro más detallado de las bajas o las eliminaciones de la API del AGP, consulta las actualizaciones de la API del AGP.

AGP 9.0 (enero de 2026)

Las nuevas API de variantes son estables y las API antiguas dejaron de estar disponibles

  • Las API de variantes que estaban en preparación en 4.1 y 4.2 son estables.
  • Todas estas interfaces se encuentran en el artefacto gradle-api.
  • Las interfaces y clases anteriores que se utilizaban en la antigua API de Variant ya no están disponibles y requieren habilitación explícita para su uso.

Las nuevas interfaces DSL son estables y las antiguas dejaron de estar disponibles

  • Las interfaces DSL que estaban en preparación en 4.1, 4.2 y 7.0 ahora son estables.
  • Todas estas interfaces se encuentran en el artefacto gradle-api.
  • Las interfaces y clases anteriores utilizadas en el DSL ya no están disponibles y requieren habilitación explícita para su uso.

Aún puedes acceder a las clases internas privadas del AGP

Se puede acceder a las clases internas privadas del AGP, ubicadas en otros artefactos, durante la compilación de archivos de compilación y complementos, pero no te recomendamos usarlas, ya que pueden cambiar por completo en cualquier momento.

AGP 10.0 (fines de 2026)

Se quitaron las API anteriores

  • Se borraron todas las interfaces y clases anteriores que se usaban en el DSL y la antigua API de variantes.
  • El artefacto gradle-api es el único que necesitas para acceder a DSL y a las interfaces y las clases de la API de variantes, y deberás usarlo cuando desarrolles complementos.

(Tentativo) Se quitó el acceso a las clases internas privadas del AGP

La dependencia del artefacto gradle ahora oculta todas las clases internas y otorga acceso de compilación solo a las interfaces y clases disponibles en el artefacto gradle-api. Esto afecta la compilación de complementos.

No es posible agregar una dependencia de forma manual a fin de obtener acceso a las clases internas.