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 versions de Kotlin requises, ainsi que les versions d'AGP et de Gradle recommandées 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é) |
|---|---|---|
| 8.0+ | 2.3.0 |
Important : Pour le SDK Navigation 8.0 et versions ultérieures, AGP 9.0.1 est une exigence minimale, et non une recommandation. Le SDK déclare |
| 7.7 - 7.9 | 2.3.0 |
|
| 7.3 - 7.6 | 2.2.10 |
|
| 6.3 - 7.2 | 2.1 |
|
| 6.0 - 6.2 | 2.0 |
|
| 5.1 - 5.99.1 | 1.9 | Nous vous recommandons d'utiliser AGP 7.3 ou version ultérieure, qui inclut une solution de contournement pour JDK-8272564. |
Compatibilité des versions de Kotlin
Kotlin 2.3 est rétrocompatible avec Kotlin 2.2. Cela signifie que si vous utilisez déjà Kotlin 2.2 avec le SDK Navigation, vous devriez pouvoir passer à Kotlin 2.3 sans avoir à résoudre toutes les modifications destructives. Toutefois, cela ne s'applique qu'aux fonctionnalités de langage 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 : options de compatibilité Kotlin
Kotlin fournit deux options pour limiter les modifications destructives : https://kotlinlang.org/docs/compatibility-modes.html
language-version X.Y
Cette option annule les modifications destructives apportées au comportement d'une version précédente de Kotlin.
Par exemple, si vous utilisez Kotlin 2.2, vous pouvez spécifier [ -
language-version 2.2], et les nouvelles modifications destructives ne prendront plus effet :
android {
kotlinOptions {
languageVersion = '2.2'
}
}
api-version X.Y
Cette option génère une erreur de compilation Gradle lorsqu'une API d'une version de Kotlin plus récente que apiVersion est utilisée.
android {
kotlinOptions {
apiVersion = '2.2'
}
}
Une approche plus ciblée
En plus d'utiliser les options de compatibilité Kotlin, nous vous recommandons de consulter les notes de version de Kotlin et de choisir les comportements que vous souhaitez conserver de la version à partir de laquelle vous effectuez la mise à niveau. Kotlin fournit une liste des modifications destructives et des options pouvant être définies pour conserver le comportement d'origine dans ses guides de compatibilité pour chaque version :
- Guide de compatibilité 2.0
- Guide de compatibilité 2.1
- Guide de compatibilité 2.2
- Guide de compatibilité 2.3
Futures mises à niveau de Kotlin
Kotlin publie une nouvelle version (c'est-à-dire une version du langage) tous les six mois, et Google intègre généralement la dernière version par défaut dans ses produits un à deux mois plus tard. Les versions précédentes de Kotlin incluaient des modifications destructives qui obligeaient les clients du SDK Navigation à passer à une version plus récente. C'est pourquoi nous vous recommandons de planifier une mise à niveau de Kotlin tous les six mois lorsque vous adoptez la dernière version du SDK Navigation.