Plug-in Android Gradle 4.2.0 (mars 2021)

Compatibilité

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 le lambda. les expressions, 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, indiquez explicitement Java 7 dans votre 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 l'outil 4.2 du plug-in Android Gradle remplace des parties du compilateur de ressources AAPT2, améliorant 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 l'APK v3. et les formats de signature APK v4. Pour activer l'un de ces formats ou les deux dans votre build, 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 d'ADB Installation incrémentielle d'APK Android 11. Ce nouvel indicateur se charge de l'étape de signature de l'APK dans le déploiement processus.

Configurer la signature d'application selon la variante

Vous pouvez désormais activer ou désactiver la signature d'application dans Android Gradle. pour chaque variante.

Cet exemple montre comment définir la signature d'application selon la variante à l'aide de la méthode onVariants() en code 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, AGP 4.2 filtre les messages des builds natifs qui utilisent CMake et ndk-build, n'affichant que 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 beaucoup de messages d'information.

Si vous souhaitez voir la sortie native dans son intégralité, définissez la nouvelle valeur 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 à partir de sous-projets. En d'autres termes, si vous déclarez une propriété dans une gradle.properties dans un sous-projet plutôt que dans la racine il sera ignoré.

Par exemple, dans les versions précédentes, l'AGP lisait les valeurs à partir 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 dans <var>projectDir</var>/gradle.properties et dans <var>projectDir</var>/app/gradle.properties, la valeur de <var>projectDir</var>/app/gradle.properties aurait prévalu.

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

Pour en savoir plus sur la définition de valeurs dans les fichiers gradle.properties, consultez les documents de 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.

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

Android Studio 4.2 peut ouvrir des projets qui utilisent AGP 3.1 et à condition qu'AGP exécute Gradle 4.8.1 ou version ultérieure. Pour plus sur la compatibilité Gradle, consultez Mettez à 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 améliorer les performances de compilation, tester vos compilations Gradle avec le un 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 Effectuer le profilage de votre build.

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

Désormais, l'AGP regroupe par défaut les fichiers DEX non compressés dans les APK lorsque la valeur de minSdk est égale ou supérieure à 28. Ce comportement provoque une augmentation de la taille de l'APK, mais réduit la taille d'installation sur l'appareil, tandis que la taille de téléchargement reste à peu près identique.

Pour forcer AGP à empaqueter à la place les fichiers DEX compressés, vous pouvez ajouter le dans le 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 dans un format non compressé, car cela réduit la taille d'installation de l'application, la taille de téléchargement de l'application et la rapidité pour vos utilisateurs. Toutefois, si vous souhaitez que le plug-in Android Gradle empaqueter des bibliothèques natives compressées lors de la création de votre application, définissez useLegacyPackaging à 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 les notes de version Bibliothèques natives empaquetées non compressées par défaut :