Compatibilité et migration des versions de Kotlin

Cette page fournit des informations sur la compatibilité des versions de Kotlin avec le SDK Navigation, ainsi que des conseils pour migrer vers une version plus récente.

Exigences concernant la version Kotlin du SDK Navigation

Le tableau suivant présente les exigences concernant la version de Kotlin, ainsi que les versions recommandées d'AGP et de Gradle pour les versions récentes du SDK Navigation.

Version du SDK Navigation	Version de Kotlin (obligatoire)	Versions du plug-in Android Gradle (AGP) et de Gradle (recommandées)
6.2+	2.1	AGP 8.7.3 Gradle 8.10.2
6.0 - 6.2	2.0	AGP 8.3.0 Gradle 8.4
5.1 - 5.99.1	1.9	Nous vous recommandons d'utiliser AGP 7.3 ou version ultérieure, qui propose une solution de contournement pour JDK-8272564.

Remarque : Les versions d'AGP recommandées listées ci-dessus tiennent compte de l'utilisation de R8/D8, qui est inclus dans AGP. Si vous n'utilisez pas R8/D8, consultez les exigences Kotlin concernant les versions minimale et maximale pour Gradle et AGP.

Compatibilité des versions de Kotlin

Kotlin 2.1 est rétrocompatible avec Kotlin 2.0. Cela signifie que si vous utilisez déjà Kotlin 2.0 avec le SDK Navigation, vous devriez pouvoir passer à Kotlin 2.1 sans avoir à résoudre toutes les modifications incompatibles. Toutefois, cela ne s'applique qu'aux fonctionnalités linguistiques stables. Si vous utilisez des fonctionnalités alpha, bêta ou expérimentales dans le langage Kotlin, vous devrez peut-être apporter des modifications supplémentaires lors de la mise à niveau.

Faciliter la transition : indicateurs de compatibilité Kotlin

Kotlin fournit deux indicateurs pour limiter les changements cassants : https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Cet indicateur rétablit les modifications incompatibles avec le comportement d'une version Kotlin précédente. Par exemple, si vous utilisez Kotlin 2.0, vous pouvez spécifier [ - language-version 2.0]. Les nouvelles modifications incompatibles ne prendront alors plus effet :

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

Cet indicateur génère une erreur de compilation Gradle lorsqu'une API d'une version Kotlin plus récente que apiVersion est utilisée.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

Une approche plus ciblée

En plus d'utiliser des indicateurs de compatibilité Kotlin, nous vous recommandons de consulter les notes de version de Kotlin et de choisir les comportements que vous souhaitez conserver à partir de la version à partir de laquelle vous effectuez la mise à niveau. Kotlin fournit une liste des changements cassants et des indicateurs qui peuvent être définis pour conserver le comportement d'origine dans ses guides de compatibilité pour chaque version :

• Guide de compatibilité 1.9
• Guide de compatibilité 2.0
• Guide de compatibilité 2.1

Futures mises à niveau de Kotlin

Kotlin publie une nouvelle version (c'est-à-dire une version du langage) tous les six mois. Google intègre généralement la dernière version par défaut dans ses produits un à deux mois après. Les versions précédentes de Kotlin ont inclus des modifications destructives qui ont obligé les clients du SDK Navigation à passer à une version plus récente. C'est pourquoi nous vous recommandons de prévoir une mise à niveau de Kotlin tous les six mois lorsque vous adoptez la dernière version du SDK Navigation.