Plug-in Android Gradle 8.0.0 (avril 2023)

Le plug-in Android Gradle 8.0.0 est une version majeure qui comprend de nombreuses nouvelles fonctionnalités et améliorations.

Compatibilité

Versions de correctif

Voici une liste des versions de correctif du plug-in Android Gradle 8.0.

Plug-in Android Gradle 8.0.2 (mai 2023)

Pour obtenir la liste des bugs corrigés dans AGP 8.0.2, consultez les problèmes résolus dans Android Studio 2022.2.1.

Plug-in Android Gradle 8.0.1 (mai 2023)

Cette mise à jour mineure inclut les corrections de bugs suivantes :

Modification destructive : espace de noms requis dans le script de compilation au niveau du module

Vous devez définir l'espace de noms dans le fichier build.gradle.kts au niveau du module, et non dans le fichier manifeste. Vous pouvez commencer à utiliser la propriété DSL namespace à partir d'AGP 7.3. Pour en savoir plus, consultez Définir un espace de noms.

Lorsque vous migrez vers le DSL d'espace de noms, tenez compte des problèmes suivants :

• Dans certains cas, les versions précédentes d'AGP déduisent de manière incorrecte l'espace de noms de test à partir de l'espace de noms principal ou de l'ID d'application. L'assistant de mise à niveau d'AGP bloque la mise à niveau s'il détecte que l'espace de noms principal et l'espace de noms de test de votre projet sont identiques. Si la mise à niveau est bloquée, vous devez modifier manuellement testNamespace et modifier votre code source en conséquence.
• Après avoir modifié l'espace de noms de test, il est possible que votre code soit compilé, mais que vos tests d'instrumentation échouent au moment de l'exécution. Cela peut se produire si le code source de votre test d'instrumentation fait référence à une ressource définie à la fois dans vos sources androidTest et dans celles de l'application.

Pour en savoir plus, consultez le commentaire 19 du problème 191813691.

Modifications destructives : valeurs par défaut des options de compilation

À partir d'AGP 8.0, les valeurs par défaut de ces options ont changé pour améliorer les performances de compilation. Pour obtenir de l'aide sur l'ajustement de votre code afin de prendre en charge certaines de ces modifications, utilisez l'assistant de mise à niveau AGP (Tools > AGP Upgrade Assistant). L'assistant de mise à niveau vous guide pour mettre à jour votre code afin de l'adapter au nouveau comportement ou de définir des indicateurs pour conserver le comportement précédent.

Modifications destructives : valeurs d'option de compilation appliquées

À partir d'AGP 8.0, vous ne pouvez plus modifier les valeurs de ces options. Si vous les spécifiez dans le fichier gradle.properties, la valeur est ignorée et AGP affiche des avertissements.

Nouvelle option stable pour le profil d'exécution

AGP inclut la nouvelle option android.settings.executionProfile. Utilisez cette option pour remplacer le profil d'exécution par défaut de SettingsExtension. Pour en savoir plus, consultez la documentation sur le plug-in de paramètres.

Pour prévisualiser les options expérimentales, consultez les notes de version preview.

Attribution de propriété différée Kotlin non prise en charge

Si vous utilisez le DSL Kotlin de Gradle pour vos scripts de compilation, notez qu'Android Studio et AGP 8.0 ne sont pas compatibles avec l'attribution de propriété expérimentale à l'aide de l'opérateur =. Pour en savoir plus sur cette fonctionnalité, consultez les notes de version et la documentation.

Catégories de tâches de Build Analyzer

À partir d'Android Studio Flamingo, Build Analyzer dispose d'une nouvelle vue par défaut pour les tâches qui ont un impact sur la durée de compilation. Si votre projet utilise AGP 8.0 ou une version ultérieure, Build Analyzer regroupe les tâches par catégorie au lieu de les afficher individuellement. Par exemple, les tâches spécifiques aux ressources Android, à Kotlin ou à Dexing sont regroupées, puis triées par durée de compilation. Cela vous aide à identifier la catégorie qui a le plus d'impact sur le temps de compilation. Développez chaque catégorie pour afficher la liste des tâches correspondantes. Pour afficher les tâches individuellement, sans les regrouper, utilisez le menu déroulant Grouper par.

Nouveau plug-in de paramètres

AGP 8.0.0-alpha09 introduit le nouveau plug-in de paramètres. Le plug-in de paramètres vous permet de centraliser les configurations globales (configurations qui s'appliquent à tous les modules) au même endroit. Vous n'avez donc pas besoin de copier-coller les configurations dans plusieurs modules. De plus, vous pouvez utiliser le plug-in de paramètres pour créer des profils d'exécution d'outils, ou différentes instructions sur la façon d'exécuter un outil, et passer de l'un à l'autre.

Pour utiliser le plug-in de paramètres, appliquez-le dans le fichier settings.gradle :

apply plugin 'com.android.settings'

Centraliser les configurations globales

Pour configurer des configurations globales, utilisez le nouveau bloc android dans le fichier settings.gradle. Exemple :

android {
  compileSdk 31
  minSdk 28
  ...
}

Profils d'exécution d'outils

Le plug-in de paramètres vous permet également de créer des profils d'exécution pour certains outils. Un profil d'exécution détermine la manière dont un outil est exécuté. Vous pouvez sélectionner différents profils d'exécution en fonction de l'environnement. Dans un profil d'exécution, vous pouvez définir des arguments JVM pour un outil et le configurer pour qu'il s'exécute dans un processus distinct. Seul l'outil R8 est compatible.

Créez des profils d'exécution et définissez le profil d'exécution par défaut dans le fichier settings.gradle, comme illustré dans l'exemple suivant :

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"
  }
}

Pour remplacer le profil par défaut, sélectionnez un autre profil à l'aide de la propriété android.experimental.settings.executionProfile dans le fichier gradle.properties :

android.experimental.settings.executionProfile=high

Vous pouvez également définir cette propriété à l'aide de la ligne de commande, ce qui vous permet de configurer différents workflows. Par exemple, si vous disposez d'un workflow d'intégration continue, vous pouvez utiliser la ligne de commande pour modifier le profil d'exécution sans avoir à modifier le fichier settings.gradle :

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

JDK 17 est requis pour exécuter AGP 8.0

Si vous utilisez le plug-in Android Gradle 8.0 pour compiler votre application, JDK 17 est désormais nécessaire pour exécuter Gradle. Android Studio Flamingo inclut JDK 17 et configure Gradle pour l'utiliser par défaut. La plupart des utilisateurs d'Android Studio n'ont donc pas besoin de modifier la configuration de leurs projets.

Si vous devez définir manuellement la version de JDK utilisée par l'AGP dans Android Studio, vous devez utiliser JDK version 17 ou supérieures.

Si vous utilisez l'AGP indépendamment d'Android Studio, mettez à niveau la version de JDK en définissant la variable d'environnement JAVA_HOME ou l'option de ligne de commande -Dorg.gradle.java.home dans votre répertoire d'installation de JDK 17.

Problèmes résolus

Plug-in Android Gradle 8.0.2

Plug-in Android Gradle 8.0.1

Plug-in Android Gradle 8.0.0