Notes de version de l'aperçu du plug-in Android Gradle

Cette page contient les notes de version des versions Preview du plug-in Android Gradle (AGP).

Plug-in Android Gradle 9.0

Le plug-in Android Gradle 9.0 est une nouvelle version majeure d'AGP qui apporte des modifications à l'API et au comportement.

Pour passer au plug-in Android Gradle 9.0.0-alpha04, utilisez l'assistant de mise à niveau du plug-in Android Gradle dans Android Studio Narwhal 4 Feature Drop | 2025.1.4.

L'assistant de mise à niveau AGP vous aide à préserver les comportements existants lors de la mise à niveau de votre projet, le cas échéant. Vous pouvez ainsi mettre à niveau votre projet pour utiliser AGP 9.0, même si vous n'êtes pas prêt à adopter toutes les nouvelles valeurs par défaut d'AGP 9.0.

Compatibilité

Le niveau d'API Android maximal compatible avec le plug-in Android Gradle 9.0.0-alpha04 est le niveau d'API 36.

Le plug-in Android Gradle 9.0.0-alpha04 nécessite Gradle 9.0.0.

Les implémentations DSL internes et l'API Variant obsolète nécessitent désormais une activation explicite

Le plug-in Android Gradle dispose désormais d'une surface d'API définie, avec des API compatibles définies dans l'artefact Maven com.android.tools.build:gradle-api.

Pour assurer la compatibilité avec les plug-ins binaires et les scripts de compilation existants, les implémentations DSL précédentes qui précèdent la surface d'API définie étaient toujours exposées par défaut dans AGP 8.13 et versions antérieures. Cela permet au code des plug-ins Gradle et des scripts de compilation d'accéder à la fois aux détails d'implémentation internes du DSL et aux API android.applicationVariants, android.libraryVariants, android.testVariants et android.unitTestVariants obsolètes, qui seront supprimées en 2026 dans AGP 10.

Pour rendre cette transition plus visible, l'ancienne API de variante et le DSL interne ne sont pas accessibles par défaut dans le plug-in Android Gradle 9.0.0-alpha04.

Vous pouvez réactiver l'API obsolète en définissant android.newDsl=false dans gradle.properties.

Au cours de la série alpha 9.0, nous contactons les auteurs de plug-ins pour les aider à adapter et à publier des plug-ins entièrement compatibles avec les nouveaux modes. Nous améliorerons également l'assistant de mise à niveau AGP dans Android Studio pour vous guider tout au long de la migration.

Kotlin intégré

Le plug-in Android Gradle 9 inclut une compatibilité intégrée pour la compilation de Kotlin, ce qui remplace le plug-in Kotlin appliqué séparément. Cela simplifie l'intégration à AGP, en évitant l'utilisation des API obsolètes et en améliorant les performances dans certains cas.

Le plug-in Android Gradle 9 a une dépendance d'exécution sur le plug-in Kotlin Gradle 2.2.0, qui est la version minimale requise pour la prise en charge intégrée de Kotlin.

Vous pouvez désactiver Kotlin intégré en définissant android.builtInKotlin=false. Si vous avez désactivé la fonctionnalité et que vous devez également utiliser une ancienne version du plug-in Gradle Kotlin, vous pouvez forcer la rétrogradation.

buildscript {
    dependencies {
        classpath("org.jetbrains.kotlin:kotlin-gradle-plugin") {
            version { strictly("2.0.0") } // or another version that you want to use
        }
    }
}

Changements de comportement

Le plug-in Android Gradle 9.0 présente les nouveaux comportements suivants :

AGP 9.0 inclut des mises à jour des valeurs par défaut des propriétés Gradle suivantes. Vous pouvez choisir de conserver le comportement de l'AGP 8.13 lors de la mise à niveau :

android {
  buildFeatures {
    shaders = true
  }
}

Fonctionnalités supprimées

Le plug-in Android Gradle 9.0 supprime les fonctionnalités suivantes :

• Compatibilité avec les applications Wear OS intégrées
  AGP 9.0 supprime la compatibilité avec l'intégration d'applications Wear OS, qui n'est plus prise en charge dans Play. Cela inclut la suppression des configurations wearApp et du DSL AndroidSourceSet.wearAppConfigurationName. Pour savoir comment publier votre application sur Wear OS, consultez Distribuer votre application sur Wear OS.
• Tâche de création de rapports androidDependencies et sourceSets

DSL modifiée

Le plug-in Android Gradle 9.0 présente les modifications importantes suivantes dans le DSL :

• La paramétrisation de CommonExtension a été supprimée. En soi, il s'agit uniquement d'un changement cassant au niveau de la source pour éviter de futurs changements cassants au niveau de la source. Toutefois, cela signifie également que les méthodes du bloc DSL doivent passer de CommonExtension à ApplicationExtension, LibraryExension, DynamicFeatureExtension et TestExtension.

DSL supprimé

Le plug-in Android Gradle 9.0 supprime les éléments suivants :

• AndroidSourceSet.jni, car il ne fonctionnait pas.

• AndroidSourceSet.wearAppConfigurationName, en ce qui concerne la suppression de la compatibilité avec l'application Wear OS intégrée.

• BuildType.isRenderscriptDebuggable, car il ne fonctionnait pas.

• ComponentBuilder.enabled a été remplacé par ComponentBuilder.enable.

• DependencyVariantSelection a été remplacé par DependencySelection, qui est exposé en tant que kotlin.android.

• Installation.installOptions(String). Elle est remplacée par la propriété mutable de Installation.installOptions.

• VariantBuilder.targetSdk et targetSdkPreview, car elles n'avaient pas de sens dans les bibliothèques. Utilisez plutôt GeneratesApkBuilder.targetSdk ou GeneratesApkBuilder.targetSdkPreview.

• Bloc PostProcessing expérimental, mais jamais stabilisé.

• ProductFlavor.setDimension, qui est remplacé par la propriété dimension

• LanguageSplitOptions, qui n'était utile que pour Google Play Instant, qui est obsolète.

• Variant.unitTest, car il n'était pas applicable au plug-in com.android.test. unitTest est disponible sur les sous-types VariantBuilder étendant HasUnitTest.

• VariantBuilder.enableUnitTest, car il n'était pas applicable au plug-in com.android.test. enableUnitTest est disponible sur les sous-types VariantBuilder étendant HasUnitTestBuilder.

• VariantBuilder.unitTestEnabled est supprimé au profit de enableUnitTest, dont le nom est plus cohérent, sur les sous-types VariantBuilder étendant HasUnitTestBuilder.

Propriétés Gradle supprimées

Les propriétés Gradle suivantes ont été ajoutées à l'origine pour désactiver globalement les fonctionnalités activées par défaut.

Ces fonctionnalités sont désactivées par défaut depuis AGP 8.0 ou version antérieure. Activez ces fonctionnalités uniquement dans les sous-projets qui les utilisent pour une compilation plus efficace.

android {
  buildFeatures {
    aidl = true
  }
}

android {
  buildFeatures {
    renderScript = true
  }
}

API supprimées

Le plug-in Android Gradle 9.0 supprime les éléments suivants :

• Les API BaseExtension.registerTransform obsolètes et désactivées, qui n'étaient conservées que pour permettre la compilation avec la dernière version d'AGP tout en ciblant l'exécution sur AGP 4.2 ou version antérieure.

Propriétés Gradle appliquées

AGP 9.0 génère une erreur si vous définissez les propriétés Gradle suivantes.

L'assistant de mise à niveau du plug-in Android Gradle ne mettra pas à niveau les projets vers AGP 9.0 qui utilisent ces propriétés.