Notes de version du plug-in Android Gradle

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.
Le dépôt JCenter est disponible en lecture seule depuis le 31 mars 2021. Pour en savoir plus, consultez Mise à jour du service JCenter.

Le système de compilation d'Android Studio est basé sur Gradle, et le plug-in Android Gradle ajoute plusieurs fonctionnalités spécifiques à la compilation d'applications Android. Bien que le plug-in Android soit généralement mis à jour en parallèle d'Android Studio, il (et le reste du système Gradle avec lui) peut fonctionner indépendamment d'Android Studio et être mis à jour séparément.

Cette page explique comment maintenir vos outils Gradle à jour et détaille le contenu des dernières mises à jour. Pour obtenir les notes de version des anciennes versions du plug-in Android Gradle, consultez les notes de version antérieures.

Pour avoir un résumé exhaustif 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 :

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 exhaustif build.gradle. 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 7.3.0 du fichier build.gradle :

Groovy

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

Kotlin

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

Attention : N'utilisez pas de dépendances dynamiques comme 'com.android.tools.build:gradle:2.+' 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.

Version du plug-inVersion minimale requise de Gradle
8.08.0
7.47.5
7.37.4
7.27.3.3
7.17.2
7.07.0
4.2.0 et versions supérieures6.7.1

Anciennes versions

Version du plug-inVersion de Gradle requise
4.1.0 et versions supérieures6.5 et versions supérieures
4.0.0 et versions supérieures6.1.1 et versions supérieures
3.6.0 à 3.6.45.6.4 et versions supérieures
3.5.0 à 3.5.45.4.1 et versions supérieures
3.4.0 à 3.4.35.1.1 et versions supérieures
3.3.0 à 3.3.34.10.1 et versions supérieures
3.2.0 à 3.2.14.6 et versions supérieures
3.1.0 et versions supérieures4.4 et versions supérieures
3.0.0 et versions supérieures4.1 et versions supérieures
2.3.0 et versions supérieures3.3 et versions supérieures
2.1.3 à 2.2.32.14.1 à 3.5
2.0.0 à 2.1.22.10 à 2.13
1.5.02.2.1 à 2.13
1.2.0 à 1.3.12.2.1 à 2.9
1.0.0 à 1.1.32.2.1 à 2.3

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 7.5.1 à 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 --7.5.1

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 7.5.1 dans le fichier gradle-wrapper.properties.

...
distributionUrl = "https\://services.gradle.org/distributions/gradle-7.5.1-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 ajoute plusieurs fonctionnalités spécifiques à la compilation d'applications Android. Le tableau suivant présente les versions du plug-in Android Gradle requises pour chaque version d'Android Studio.

Version d'Android Studio Version requise du plug-in
Flamingo | 2022.2.1 3.2-8.0
Electric Eel | 2022.1.1 3.2-7.4
Dolphin | 2021.3.1 3.2-7.3
Chipmunk | 2021.2.1 3.2-7.2
Bumblebee | 2021.1.1 3.2-7.1
Arctic Fox | 2020.3.1 3.1-7.0

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

Modifications par version (novembre 2020)

Mise à jour de la numérotation de version du plug-in d'Android Gradle (AGP) afin qu'il corresponde plus précisément à l'outil de compilation Gradle sous-jacent.

Modifications importantes :

  • L'AGP utilisera désormais des dénominations sémantiques de versions, et les modifications importantes seront effectuées dans les versions majeures.

  • Une version majeure de l'AGP sera publiée chaque année, en même temps que la version majeure de Gradle.

  • La version 7.0 de l'AGP suivra la version 4.2 et nécessitera une mise à niveau vers la version 7.x de Gradle. Chaque version majeure de l'AGP nécessite une mise à niveau majeure de version dans l'outil Gradle sous-jacent.

  • Les API seront abandonnées environ un an à l'avance, et les fonctionnalités de remplacement seront disponibles simultanément. Les API obsolètes seront supprimées environ un an plus tard lors de la mise à jour majeure suivante.

7.3.0 (septembre 2022)

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

Compatibilité

Version minimale Version par défaut Notes
Gradle 7.4 7.4 Pour en savoir plus, consultez Mettre à jour Gradle.
Build Tools SDK 30.0.3 30.0.3 Installez ou configurez des Build Tools SDK.
NDK N/A 23.1.7779620 Installez ou configurez une autre version du NDK.
JDK 11 11 Pour en savoir plus, consultez Définir la version du JDK.

Compatibilité avec les systèmes de compilation C/C++ personnalisés

Vous pouvez maintenant créer un système de compilation C/C++ personnalisé en générant un script shell qui écrit les informations de compilation dans le format de fichier de compilation Ninja. Pour en savoir plus sur les systèmes de compilation C/C++ personnalisés, consultez Intégrer des systèmes de compilation C/C++ personnalisés à l'aide de Ninja (expérimental).

Capture d'écran du système de compilation C/C++ personnalisé

La version minimale du plug-in Kotlin est 1.5.20

À partir de la version 7.3.0-alpha08 du plug-in Android Gradle, AGP nécessite le plug-in Kotlin version 1.5.20 ou ultérieure. Pour assurer la compatibilité, veillez à spécifier la version 1.5.20 ou ultérieure du plug-in Kotlin dans votre fichier build.gradle :

org.jetbrains.kotlin:kotlin-gradle-plugin:1.5.20

Activation de la génération des APK archivés

À partir de la version 7.3 d'AGP, tous les packages Android App Bundle dont l'archivage est géré sont activés par défaut. L'archivage est une nouvelle fonctionnalité d'app bundle qui, à l'avenir, permettra aux utilisateurs ayant peu d'espace de stockage de gérer efficacement l'espace de leur application, si le Play Store le permet.

Pour désactiver la génération des APK archivés, modifiez le fichier build.gradle au niveau de l'application comme suit :

android {
  bundle {
    storeArchive {
      enable = false
    }
  }
}

L'attribut de package dans le fichier manifeste est obsolète

À partir de la version AGP 7.3.0-alpha04, lorsque vous utilisez Gradle pour créer votre projet, AGP génère un avertissement si vous utilisez l'attribut package dans le fichier manifeste. Pour définir l'espace de noms de votre application, utilisez la propriété namespace dans le fichier build.gradle au niveau du module. Pour en savoir plus, consultez la section Définir un espace de noms.

Pour obtenir de l'aide sur le passage au nouvel espace de noms DSL, utilisez l'assistant de mise à niveau AGP (Tools > AGP Upgrade Assistant).

Prise en charge de la plate-forme Android

À partir de la version 7.3.0-beta05 d'AGP, la version minimale compatible du SDK est 33 (vous pouvez utiliser minSdk = 33). Le SDK minimal représente la version minimale d'Android sur laquelle votre application peut s'exécuter. Il est défini dans le fichier build.gradle au niveau de l'application.