Migración de proyectos Flutter de Android a Kotlin integrado

Para compilar una aplicación de Flutter para Android, se debe utilizar el Android Gradle Plugin (AGP). Para utilizar AGP 9 y versiones posteriores, se requieren las siguientes migraciones.

Primero, el Kotlin incorporado es el predeterminado en AGP 9 y versiones posteriores. Las aplicaciones que utilizan el complemento kotlin-android, también conocido como el Kotlin Gradle Plugin (KGP), fallarán al compilarse (Issue #181383). Sin embargo, el equipo de Flutter ha añadido soporte temporal para el Kotlin Gradle Plugin heredado en AGP 9 y versiones posteriores (Issue #183909). Esto permite a los desarrolladores de aplicaciones y complementos compilar de forma segura sus proyectos independientemente de su estado de migración.

Segundo, AGP 9 y versiones posteriores solo utilizan las nuevas interfaces DSL de AGP. Esto significa que no se reconocerá ningún tipo de DSL antiguo. El equipo de Flutter está trabajando en la migración de los tipos de DSL antiguos para utilizar el nuevo DSL: Issue #180137. Mientras tanto, el equipo de Flutter ha configurado el DSL de AGP para que sea compatible con los tipos de DSL heredados (Issue #184838). Esto garantiza que los desarrolladores de aplicaciones y complementos puedan actualizar de forma segura a AGP 9 y versiones posteriores.

Para garantizar la compatibilidad, migra manualmente todas las aplicaciones y complementos del KGP heredado a Kotlin incorporado. Flutter planea eliminar el soporte para aplicar KGP en una versión futura (Issue #184837).

Para obtener más información sobre el Android Gradle Plugin, consulta la documentación del Android Gradle Plugin.

Para desarrolladores de aplicaciones: Sigue la guía de migración para desarrolladores de aplicaciones.

Para autores de complementos: Sigue la guía de migración para autores de complementos.

• Eliminar el soporte para KGP: En una versión futura de Flutter, se eliminará el soporte para aplicar KGP (Issue #184837). Migra las aplicaciones, complementos y aplicaciones host para que sigan compilando.

• Eliminar la propiedad de Gradle DSL: Una vez que el equipo de Flutter complete la migración al nuevo DSL de AGP, se eliminará el soporte para el DSL antiguo (Issue #184839).

Introducido en la versión: 3.44.0-0.1.pre
En el lanzamiento estable: 3.44

Issues relevantes:

• Issue #180137: Migrar del antiguo al nuevo DSL de AGP
• Issue #181383: Los complementos de Flutter deben ser compatibles con AGP 9.0.0
• Issue #183909: Añadir soporte para KGP en AGP+
• Issue #184837: Eliminar soporte para KGP
• Issue #184838: Desactivar la bandera del nuevo DSL de AGP por defecto
• Issue #184839: Eliminar soporte para los tipos antiguos de DSL de AGP

Los archivos de compilación de Gradle en tu aplicación varían según la versión de Flutter utilizada al crear tu aplicación. Considera mantenerte al día con la última versión de los archivos de compilación ejecutando periódicamente flutter upgrade en el directorio de tu aplicación.