Migration pour le SDK client Android v2.0.0

Mises à jour de Gradle et du plug-in Android Gradle

Mettre à niveau les versions de Gradle et du plug-in Android Gradle

Tout d'abord, mettez à niveau vos versions de Gradle et du plug-in Android Gradle. Cette mise à niveau inclut une meilleure compatibilité avec certaines dépendances de SDK (y compris Kotlin 1.9), ainsi que des corrections de bugs critiques.

Cette version majeure du SDK nécessite les dépendances de version suivantes pour votre projet d'application Android :

  • Une version de Gradle au moins égale à la version 7.5.0, mais ne dépassant pas la version 7.6.0.
  • une version du plug-in Android Gradle (AGP) comprise entre la version 7.4.x et la version 7.4.x.

Vous pouvez cibler une version plus récente des plug-ins. Toutefois, vous risquez de rencontrer des avertissements d'abandon ou de ne pas pouvoir utiliser certaines nouvelles fonctionnalités.

Pour modifier la version de Gradle, modifiez la ligne dans le fichier /gradle/wrapper/gradle-wrapper.properties de votre projet.

distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip

Pour modifier la version du plug-in Android Gradle, modifiez le fichier build.gradle qui contient le bloc buildscript. Exemple :

buildscript {
    repositories {
        google()
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

Migration de la compatibilité des bibliothèques de Java 7 vers Java 8

Étape 1 : Activez la compatibilité avec la bibliothèque Java 8

Source

Étant donné que le niveau d'API minimal du SDK est 23 et que la version d'AGP requise est 7.4 ou ultérieure, la configuration est légèrement différente de celle de la documentation source mentionnée.

buildscript {

    repositories {
        google()
        mavenCentral()
        jcenter()
        maven {
            url = uri("https://storage.googleapis.com/r8-releases/raw")
        }
    }
    dependencies {
        classpath 'com.android.tools:r8:8.0.46'
        classpath 'com.android.tools.build:gradle:7.4.1'
    }
}

android {
    compileOptions {
        // Flag to enable support for the new language APIs
        coreLibraryDesugaringEnabled true
        // Sets Java compatibility to Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {
    coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs_nio:2.0.3'
}

Étape 2 : Migrer de Proguard ou Dexguard vers R8

R8, source

AGP v7.4 et versions ultérieures utilisent R8 comme outil par défaut de réduction, d'obscurcissement et d'optimisation pour le binaire. Aucune action spéciale n'est donc requise à ce stade.

Si le projet est migré depuis AGP 4.0 ou une version ultérieure, AGP peut émettre les avertissements suivants concernant les suppressions de fichiers :

  • Utilisation de useProguard true dans le fichier build.gradle
  • Utilisation de android.enableR8=false dans le fichier gradle.properties

La suppression de ces lignes résout généralement ces problèmes.

Migration de Kotlin 1.6 vers la version 1.9

Étape 1 : Migrer vers le plug-in Kotlin Gradle 1.9.0

Source

Mettez à jour la version du plug-in Gradle Kotlin dans le fichier build.gradle du module de premier niveau de votre application. Veillez à ajouter org.jetbrains.kotlin:kotlin-gradle-plugin dans les dépendances du bloc buildscript s'il est manquant.

buildscript {
  dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
  }
}

Vous devez migrer votre application depuis Kotlin-synthetics si vous utilisez le plug-in Kotlin Gradle 1.6.X ou 1.7.X. Pour en savoir plus, consultez le guide de migration officiel.

Étape 2 : Mettez à niveau kotlin-stdlib vers la version 1.9.0

Source

Passez à la version 1.9.0 de kotlin-stblib dans le fichier build.gradle de votre application.

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
}

Veillez à supprimer toutes les références à kotlin-stdlib-jdk7 ou kotlin-stdlib-jdk8. Les deux dépendances ont été regroupées dans kotlin-stdlib à partir de Kotlin 1.8.0.