Guía de migración de Android Java Gradle

Si has actualizado recientemente Android Studio a la versión Flamingo y has ejecutado o compilado una aplicación Android existente, es posible que te hayas encontrado con un error similar al siguiente:

Caused by: org.codehaus.groovy.control.MultipleCompilationErrorsException: startup failed:

La salida de la terminal para este error es similar a la siguiente:

FAILURE: Build failed with an exception.

* Where:
Build file '…/example/android/build.gradle'
* What went wrong:
Could not compile build file '…/example/android/build.gradle'.
> startup failed:
  General error during conversion: Unsupported class file major version 61

  java.lang.IllegalArgumentException: Unsupported class file major version 61
  	at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:189)
  	at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:170)
  	[…
  	 …
  	 … 209 more lines of Groovy and Gradle stack trace …
  	 …
  	 …]
  	at java.base/java.lang.Thread.run(Thread.java:833)

Este error ocurre porque Android Studio Flamingo actualiza su SDK de Java incluido de la versión 11 a la 17. Flutter utiliza la versión de Java incluida con Android Studio para compilar aplicaciones Android. Las versiones de Gradle anteriores a la 7.3 no pueden ejecutarse cuando se utiliza Java 17.

Puedes solucionar este error actualizando tu proyecto de Gradle a una versión compatible (de la 7.3 a la 7.6.1, inclusive) utilizando uno de los siguientes enfoques.

Actualiza la versión de Gradle en Android Studio Flamingo de la siguiente manera:

1. En Android Studio, abre la carpeta android. Esto debería mostrar el siguiente diálogo:

   

   Actualiza a una versión de Gradle entre la 7.3 y la 7.6.1, inclusive.

2. Sigue el flujo de trabajo guiado para actualizar Gradle.

   

Realiza lo siguiente desde la raíz de tu proyecto Flutter.

1. Ve al directorio Android de tu proyecto.

   $ cd android
   

   content_copy

2. Actualiza Gradle a la versión preferida. Elige entre la 7.3 y la 7.6.1, inclusive.

   $ ./gradlew wrapper --gradle-version=7.6.1
   

   content_copy

El error aparece de forma similar a Unsupported class file major version 65. Esto indica que tu versión de Java es más nueva de lo que la versión de Gradle que estás ejecutando puede manejar. Existe un conjunto no obvio de dependencias en torno a AGP, Java y Gradle.

La forma más fácil de resolver este problema es utilizar el asistente de actualización de AGP de Android Studio. Para usarlo, selecciona tu archivo build.gradle de nivel superior en Android Studio y luego selecciona Tools -> AGP Upgrade Assistant.

Ejecuta flutter analyze --suggestions para ver si tus versiones de AGP, Java y Gradle son compatibles. Si es necesario actualizar Gradle, puedes actualizarlo con ./gradlew wrapper --gradle-version=SOMEGRADLEVERSION donde SOMEGRADLEVERSION es la versión (puedes usar una versión más nueva) sugerida por flutter analyze.

Para encontrar la versión de Java que se está utilizando, ejecuta flutter doctor. En un mac, puedes encontrar las versiones de Java que el sistema operativo conoce con /usr/libexec/java_home -V. Para configurar la versión de Java que utilizan todos los proyectos de flutter, ejecuta flutter config --jdk-dir=SOMEJAVAPATH donde SOMEJAVAPATH es la ruta a una versión de Java como /opt/homebrew/Cellar/openjdk@17/17.0.13/libexec/openjdk.jdk/Contents/Home

Algunas notas a tener en cuenta:

• Repite este paso para cada aplicación Android afectada.
• Este problema lo pueden experimentar quienes no descargan Java y el SDK de Android a través de Android Studio. Si has actualizado manualmente tu SDK de Java a la versión 17 pero no has actualizado Gradle, también puedes experimentar este problema. La solución es la misma: actualizar Gradle a una versión entre la 7.3 y la 7.6.1.
• Your development machine might contain more than one copy of the Java SDK:
  • La aplicación Android Studio incluye una versión de Java, que Flutter utiliza por defecto.
  • Si no tienes instalado Android Studio, Flutter depende de la versión definida por la variable de entorno JAVA_HOME de tu script de shell.
  • Si JAVA_HOME no está definida, Flutter busca cualquier ejecutable de java en tu ruta. El comando flutter doctor -v informa qué versión de Java se está utilizando.
• Si actualizas Gradle a una versión más reciente que la 7.6.1, podrías (aunque es poco probable) encontrar problemas que resulten de cambios en Gradle, como clases de Gradle obsoletas, o cambios en la estructura de archivos de Android. Si esto ocurre, vuelve a una versión de Gradle entre la 7.3 y la 7.6.1, inclusive.
• Actualizar a Flutter 3.10 no solucionará este problema.