À propos du plug-in Android Gradle

Le système de compilation Android Studio est basé sur Gradle, et le plug-in Android Gradle ajoute plusieurs fonctionnalités spécifiques à la compilation d'applications Android.

Cette page explique comment maintenir vos outils Gradle à jour. Pour consulter les notes de version du plug-in Android Gradle, accédez à la page des notes de version.

Pour un résumé global des modifications importantes à venir dans le plug-in Android Gradle, consultez la feuille de route du plug-in Android Gradle.

Pour savoir comment configurer vos builds Android avec Gradle, consultez les pages suivantes :

• Configurer votre build
• Référence du DSL du plug-in Android Gradle
• Référence du DSL Gradle
• Guide de l'utilisateur pour les performances Gradle

Pour en savoir plus sur le système de compilation Gradle, consultez le guide de l'utilisateur Gradle.

Mettre à jour le plug-in Android Gradle

Lorsque vous mettez à jour Android Studio, vous pouvez être invité à installer automatiquement la dernière version disponible du plug-in Android Gradle. Vous pouvez accepter la mise à jour ou indiquer manuellement une version spécifique en fonction des exigences de compilation de votre projet.

Vous pouvez préciser la version du plug-in soit via le menu File > Project Structure > Project (Fichier > Structure du projet > Projet) d'Android Studio, soit via le fichier build.gradle.kts de premier niveau. La version du plug-in s'applique à tous les modules créés dans ce projet Android Studio. L'exemple suivant définit le plug-in sur la version 9.0 du fichier build.gradle.kts :

plugins {
    id("com.android.application") version "9.0" apply false
    id("com.android.library") version "9.0" apply false
    id("org.jetbrains.kotlin.android") version "2.2.21" apply false
}

plugins {
    id 'com.android.application' version '9.0' apply false
    id 'com.android.library' version '9.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.2.21' apply false
}

Attention : N'utilisez pas de dépendances dynamiques comme 'com.android.tools.build:gradle:9.+' dans les numéros de version. L'utilisation de cette fonctionnalité peut entraîner des mises à jour inattendues et des problèmes pour résoudre les différences de version.

Si la version du plug-in indiquée n'a pas été téléchargée, Gradle la télécharge la prochaine fois que vous compilez votre projet ou cliquez sur File > Sync Project with Gradle Files (Fichier > Synchroniser le projet avec les fichiers Gradle) dans la barre de menu d'Android Studio.

Mettre à jour Gradle

En mettant à jour Android Studio, vous pouvez également recevoir une invite pour mettre à jour Gradle vers la dernière version disponible. Vous pouvez accepter la mise à jour ou indiquer manuellement une version spécifique en fonction des exigences de compilation de votre projet.

Le tableau suivant indique les versions de Gradle requises pour chaque version du plug-in Android Gradle. Pour optimiser les performances, utilisez la dernière version possible de Gradle et du plug-in.

Vous pouvez indiquer la version de Gradle spécifique soit via le menu File > Project Structure > Project (Fichier > Structure du projet > Projet) d'Android Studio, soit en mettant à jour votre version de Gradle à l'aide de la ligne de commande. La méthode privilégiée consiste à utiliser l'outil de ligne de commande Gradle Wrapper, qui met à jour les scripts gradlew. L'exemple suivant définit la version de Gradle sur la version 9.1.0 à l'aide de Gradle Wrapper. Notez que vous devez exécuter cette commande deux fois pour mettre à niveau à la fois Gradle et Gradle Wrapper lui-même (pour en savoir plus, consultez Mettre à niveau Gradle Wrapper).

gradle wrapper --gradle-version 9.1.0

Toutefois, cela peut échouer dans certains cas, par exemple si vous venez de mettre à jour l'AGP et qu'il n'est plus conforme à la version actuelle de Gradle. Dans ce cas, modifiez la référence de distribution Gradle dans le fichier gradle/wrapper/gradle-wrapper.properties. L'exemple suivant définit la version de Gradle sur la version 9.1.0 dans le fichier gradle-wrapper.properties.

...
distributionUrl = https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
...

Compatibilité entre le plug-in Android Gradle et Android Studio

Le système de compilation Android Studio est basé sur Gradle, et le plug-in Android Gradle (AGP) ajoute plusieurs fonctionnalités spécifiques à la compilation d'applications Android. Le tableau suivant indique la version de l'AGP requise pour chaque version d'Android Studio.

Pour en savoir plus sur les nouveautés du plug-in Android Gradle, consultez les notes de version du plug-in Android Gradle.

Versions minimales des outils pour le niveau d'API Android

Il existe des versions minimales d'Android Studio et d'AGP compatibles avec un niveau d'API spécifique. L'utilisation de versions antérieures d'Android Studio ou d'AGP à celles requises par les éléments targetSdk ou compileSdk de votre projet pourrait entraîner des problèmes inattendus. Nous vous recommandons d'utiliser la dernière version preview d'Android Studio et d'AGP pour travailler sur des projets qui ciblent les versions preview de l'OS Android. Vous pouvez installer des versions preview d'Android Studio en plus d'une version stable.

Les versions minimales d'Android Studio et d'AGP sont les suivantes :