Complemento de Android para Gradle 8.0.0 (abril de 2023)

El complemento de Android para Gradle 8.0.0 es una actualización importante que incluye una variedad de nuevas funciones y mejoras.

Compatibilidad

Versiones de parches

La siguiente es una lista de las versiones de parche para el complemento de Android para Gradle 8.0.

Complemento de Android para Gradle 8.0.2 (mayo de 2023)

Para obtener una lista de los errores corregidos en AGP 8.0.2, consulta los problemas cerrados de Android Studio 2022.2.1.

Complemento de Android para Gradle 8.0.1 (mayo de 2023)

Esta actualización menor incluye las siguientes correcciones de errores:

Cambio drástico: Se requiere un espacio de nombres en la secuencia de comandos de compilación a nivel del módulo

Debes configurar el espacio de nombres en el archivo build.gradle.kts a nivel del módulo, en lugar del archivo de manifiesto. Puedes comenzar a usar la propiedad DSL namespace a partir de AGP 7.3. Para obtener más información, consulta Configura un espacio de nombres.

Cuando migres a la DSL de espacio de nombres, ten en cuenta los siguientes problemas:

• En algunos casos, las versiones anteriores de AGP infieren el espacio de nombres de prueba del espacio de nombres principal o del ID de aplicación de forma incorrecta. El Asistente de actualización de AGP bloquea la actualización si detecta que el espacio de nombres principal y el de prueba de tu proyecto son los mismos. Si la actualización está bloqueada, debes cambiar testNamespace manualmente y modificar el código fuente según corresponda.
• Después de cambiar el espacio de nombres de prueba, es posible que el código se compile, pero que las pruebas de instrumentación fallen durante el tiempo de ejecución. Esto puede suceder si tu código fuente de prueba instrumentada hace referencia a un recurso definido en tu androidTest y en las fuentes de la app.

Para obtener más información, consulta el comentario n.° 19 del problema #191813691.

Cambios rotundos: valores predeterminados de la opción de compilación

A partir de AGP 8.0, los valores predeterminados de estas marcas cambiaron para mejorar el rendimiento de la compilación. Para obtener ayuda para ajustar tu código y admitir algunos de estos cambios, usa el Asistente de actualización del AGP (Tools > AGP Upgrade Assistant). El Asistente de actualización te guía para actualizar tu código y adaptarlo al comportamiento nuevo o configurar marcas para preservar el comportamiento anterior.

Cambios rotundos: Valores de opciones de compilación forzosos

A partir de AGP 8.0, ya no puedes cambiar los valores de estas marcas. Si los especificas en el archivo gradle.properties, se ignora el valor y AGP imprime advertencias.

Nueva marca estable para el perfil de ejecución

AGP incluye la nueva marca android.settings.executionProfile. Usa esta marca para anular el perfil de ejecución predeterminado de SettingsExtension. Para obtener más información, consulta la documentación del complemento de configuración.

Para obtener una vista previa de las marcas experimentales, consulta las notas de la versión preliminar.

No se admite la asignación de propiedades diferidas de Kotlin.

Si usas el DSL de Kotlin de Gradle para tus secuencias de comandos de compilación, ten en cuenta que Android Studio y AGP 8.0 no admiten la asignación experimental de propiedades con el operador =. Para obtener más información sobre esta función, consulta las notas de la versión y la documentación.

Categorías de tareas de Build Analyzer

A partir de Android Studio Flamingo, el analizador de compilaciones tiene una nueva vista predeterminada para las tareas que afectan la duración de la compilación. Si tu proyecto usa AGP 8.0 o una versión posterior, en lugar de mostrar las tareas de forma individual, Build Analyzer las agrupa por categoría. Por ejemplo, las tareas específicas de los recursos de Android, Kotlin o Dexing se agrupan y, luego, se ordenan por duración de compilación. Esto facilita saber qué categoría tiene el mayor impacto en el tiempo de compilación. Si expandes cada categoría, se mostrará una lista de las tareas correspondientes. Para mostrar las tareas de forma individual, ilmas agruparlas, usa el menú desplegable Agrupar por.

Nuevo complemento de configuración

AGP 8.0.0-alpha09 presenta el nuevo complemento de configuración. El complemento de configuración te permite centralizar las configuraciones globales (configuraciones que se aplican a todos los módulos) en un solo lugar para que no tengas que copiar y pegar las configuraciones en varios módulos. Además, puedes usar el complemento de configuración para crear perfiles de ejecución de herramientas o diferentes instrucciones para ejecutar una herramienta y cambiar entre ellas.

Para usar el complemento de configuración, aplícalo en el archivo settings.gradle:

apply plugin 'com.android.settings'

Cómo centralizar las configuraciones globales

Para configurar parámetros de configuración globales, usa el nuevo bloque android en el archivo settings.gradle. Por ejemplo:

android {
  compileSdk 31
  minSdk 28
  ...
}

Perfiles de ejecución de herramientas

El complemento de configuración también te permite crear perfiles de ejecución para algunas herramientas. Un perfil de ejecución determina cómo se ejecuta una herramienta. Puedes seleccionar diferentes perfiles de ejecución según el entorno. En un perfil de ejecución, puedes establecer argumentos de JVM para una herramienta y configurarla para que se ejecute en un proceso independiente. Actualmente, solo se admite la herramienta R8.

Crea perfiles de ejecución y configura el perfil de ejecución predeterminado en el archivo settings.gradle, como se muestra en el siguiente ejemplo:

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

Para anular el perfil predeterminado, selecciona uno diferente con la propiedad android.experimental.settings.executionProfile en el archivo gradle.properties:

android.experimental.settings.executionProfile=high

También puedes establecer esta propiedad con la línea de comandos, que te permite configurar diferentes flujos de trabajo. Por ejemplo, si tienes un flujo de trabajo de integración continua, puedes usar la línea de comandos para cambiar el perfil de ejecución sin tener que cambiar el archivo settings.gradle:

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

Se requiere JDK 17 para ejecutar AGP 8.0

Cuando usas el complemento de Android para Gradle 8.0 para compilar tu app, ahora se requiere JDK 17 para ejecutar Gradle. Android Studio Flamingo empaqueta JDK 17 y configura Gradle para usarlo de forma predeterminada. Esto significa que la mayoría de los usuarios de Android Studio no necesitan hacer cambios en la configuración de sus proyectos.

Si necesitas configurar manualmente la versión de JDK que usa AGP dentro de Android Studio, debes usar JDK 17 o una versión posterior.

Cuando uses AGP independiente de Android Studio, actualiza la versión de JDK configurando la variable de entorno JAVA_HOME o la opción de línea de comandos -Dorg.gradle.java.home en el directorio de instalación de JDK 17.

Errores corregidos

Complemento de Android para Gradle 8.0.0

Complemento de Android para Gradle 8.0.1

Complemento de Android para Gradle 8.0.2