Cette page a été traduite par l'API Cloud Translation.

Plug-in Android Gradle 4.2.0 (mars 2021)

Compatibilité

	Version minimale	Version par défaut	Notes
Gradle	6.7.1	N/A	Pour en savoir plus, consultez Mettre à jour Gradle.
Build Tools SDK	30.0.2	30.0.2	Installez ou configurez des Build Tools SDK.
NDK	N/A	21.4.7075529	Installez ou configurez une autre version du NDK.

Nouvelles fonctionnalités

Cette version du plug-in d'Android Gradle inclut les nouvelles fonctionnalités suivantes.

Langage Java version 8 par défaut

À partir de la version 4.2, l'AGP utilisera le niveau de langage Java 8 par défaut. Java 8 permet d'accéder à un certain nombre de fonctionnalités de langage plus récentes, y compris les expressions lambda, les références de méthodes et les méthodes d'interface statiques. Pour obtenir la liste complète des fonctionnalités compatibles, consultez la documentation Java 8.

Pour conserver l'ancien comportement, spécifiez Java 7 explicitement dans le fichier build.gradle.kts ou build.gradle au niveau du module:

// build.gradle
android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_7
    targetCompatibility JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

// build.gradle.kts
android {
  ...
  compileOptions {
    sourceCompatibility = JavaVersion.VERSION_1_7
    targetCompatibility = JavaVersion.VERSION_1_7
  }
  // For Kotlin projects, compile to Java 6 instead of 7
  kotlinOptions {
    jvmTarget = "1.6"
  }
}

Nouveau compilateur de ressources JVM

Un nouveau compilateur de ressources JVM dans le plug-in Android Gradle 4.2 remplace certaines parties du compilateur de ressources AAPT2, ce qui peut améliorer les performances de compilation, en particulier sur les machines Windows. Le nouveau compilateur de ressources JVM est activé par défaut.

Signature v3 et v4 désormais compatible

Le plug-in Android Gradle 4.2 est désormais compatible avec les formats de signature APK v3 et APK v4. Pour activer l'un de ces formats ou les deux dans votre compilation, ajoutez les propriétés suivantes à votre fichier build.gradle ou build.gradle.kts au niveau du module:

// build.gradle
android {
  ...
  signingConfigs {
    config {
        ...
        enableV3Signing true
        enableV4Signing true
    }
  }
}

// build.gradle.kts
android {
  ...
  signingConfigs {
      config {
          ...
          enableV3Signing = true
          enableV4Signing = true
      }
  }
}

La signature APK v4 vous permet de déployer rapidement des APK volumineux à l'aide de l'installation d'APK incrémentiel ADB dans Android 11. Ce nouvel indicateur se charge de l'étape de signature de l'APK dans le processus de déploiement.

Configurer la signature d'application selon la variante

Il est maintenant possible d'activer ou de désactiver la signature d'application dans le plug-in Android Gradle par variante.

Cet exemple montre comment définir la signature d'application par variante à l'aide de la méthode onVariants() en Kotlin ou Groovy:

androidComponents {
    onVariants(selector().withName("fooDebug"), {
        signingConfig.enableV1Signing.set(false)
        signingConfig.enableV2Signing.set(true)
    })

Nouvelle propriété Gradle : `android.native.buildOutput`

Pour réduire l'encombrement de la sortie de compilation, l'AGP 4.2 filtre les messages des compilations natives qui utilisent CMake et ndk-build, en affichant uniquement la sortie du compilateur C/C++ par défaut. Auparavant, une ligne de sortie était générée pour chaque fichier compilé, ce qui entraînait une grande quantité de messages d'information.

Si vous souhaitez voir l'intégralité de la sortie native, définissez la nouvelle propriété Gradle android.native.buildOutput sur verbose.

Vous pouvez définir cette propriété dans le fichier gradle.properties ou via la ligne de commande.

gradle.properties
android.native.buildOutput=verbose

Ligne de commande
-Pandroid.native.buildOutput=verbose

La valeur par défaut de cette propriété est quiet

Modification du comportement des fichiers gradle.properties

À partir de la version 4.2 de l'AGP, il n'est plus possible de remplacer les propriétés Gradle des sous-projets. En d'autres termes, si vous déclarez une propriété dans un fichier gradle.properties d'un sous-projet au lieu du projet racine, elle sera ignorée.

Par exemple, dans les versions précédentes, l'AGP lisait les valeurs de <var>projectDir</var>/gradle.properties, <var>projectDir</var>/app/gradle.properties, <var>projectDir</var>/library/gradle.properties, etc. Pour les modules d'application, si la même propriété Gradle était présente à la fois dans <var>projectDir</var>/gradle.properties et <var>projectDir</var>/app/gradle.properties, la valeur de <var>projectDir</var>/app/gradle.properties prévaut.

Dans l'AGP 4.2, ce comportement a été modifié, et l'AGP ne charge pas les valeurs de gradle.properties dans les sous-projets (par exemple, <var>projectDir</var>/app/gradle.properties). Cette modification reflète le nouveau comportement de Gradle et est compatible avec la mise en cache de la configuration.

Pour en savoir plus sur la définition des valeurs dans les fichiers gradle.properties, consultez la documentation Gradle.

Compatibilité avec Gradle et modifications de configuration

Lorsqu'il s'exécute dans Android Studio, l'outil de compilation Gradle utilise le JDK fourni par Studio. Dans les versions précédentes, JDK 8 était fourni avec Studio. Dans la version 4.2, cependant, JDK 11 est désormais fourni à la place. L'utilisation du nouveau JDK fourni pour exécuter Gradle peut entraîner une incompatibilité ou une incidence sur les performances de la JVM en raison de modifications apportées au récupérateur de mémoire. Ces problèmes sont décrits ci-dessous.

Remarque:Bien que nous vous recommandions d'exécuter Gradle avec JDK 11, il est possible de modifier le JDK utilisé pour exécuter Gradle dans la boîte de dialogue Project Structure (Structure du projet). La modification de ce paramètre ne modifie que le JDK utilisé pour exécuter Gradle. Il ne modifie pas le JDK utilisé pour exécuter Studio lui-même.

Compatibilité de Studio avec le plug-in Android Gradle (AGP)

Android Studio 4.2 peut ouvrir des projets qui utilisent l'AGP 3.1 ou version ultérieure, à condition qu'AGP exécute Gradle 4.8.1 ou version ultérieure. Pour en savoir plus sur la compatibilité de Gradle, consultez Mettre à jour Gradle.

Optimiser les builds Gradle pour JDK 11

Cette mise à jour de JDK 11 a une incidence sur la configuration par défaut du récupérateur de mémoire de la JVM, car JDK 8 utilise le récupérateur de mémoire parallèle, tandis que JDK 11 utilise le récupérateur de mémoire G1.

Pour potentiellement améliorer les performances de compilation, nous vous recommandons de tester vos compilations Gradle avec le récupérateur de mémoire parallèle. Dans gradle.properties, définissez les paramètres suivants :

org.gradle.jvmargs=-XX:+UseParallelGC

Si d'autres options sont déjà définies dans ce champ, ajoutez une nouvelle option :

org.gradle.jvmargs=-Xmx1536m -XX:+UseParallelGC

Pour mesurer la vitesse de compilation à l'aide de différentes configurations, consultez Profiler votre build.

Fichiers DEX non compressés dans les APK si la valeur de `minSdk` est égale ou supérieure à 28

L'AGP regroupe désormais par défaut les fichiers DEX non compressés dans les APK lorsque la valeur de minSdk est égale ou supérieure à 28. Cela entraîne une augmentation de la taille de l'APK, mais une taille d'installation plus petite sur l'appareil et la taille de téléchargement reste à peu près la même.

Pour forcer l'AGP à empaqueter les fichiers DEX compressés à la place, vous pouvez ajouter les éléments suivants à votre fichier build.gradle:

android {
    packagingOptions {
        dex {
            useLegacyPackaging true
        }
    }
}

Utiliser le DSL pour regrouper des bibliothèques natives compressées

Nous vous recommandons d'empaqueter les bibliothèques natives sous forme non compressée, car cela permet de réduire la taille d'installation et de téléchargement de l'application, ainsi que le temps de chargement de l'application pour vos utilisateurs. Toutefois, si vous souhaitez que le plug-in Android Gradle empaquette les bibliothèques natives compressées lors de la compilation de votre application, définissez useLegacyPackaging sur true dans le fichier build.gradle de votre application:

android {
    packagingOptions {
        jniLibs {
            useLegacyPackaging true
        }
    }
}

L'indicateur useLegacyPackaging remplace l'attribut manifeste extractNativeLibs. Pour en savoir plus, consultez la note de version Bibliothèques natives empaquetées non compressées par défaut.