Kotlin-Versionskompatibilität und -Migration

Auf dieser Seite finden Sie Informationen zur Kotlin-Versionskompatibilität für das Navigation SDK sowie eine Anleitung zur Migration zu einer neueren Version.

Anforderungen an die Kotlin-Version für das Navigation SDK

In der folgenden Tabelle sind die Anforderungen an die Kotlin-Version und die empfohlenen AGP- und Gradle-Versionen für aktuelle Versionen des Navigation SDK aufgeführt.

Navigation SDK-Version	Kotlin-Version (erforderlich)	Android Gradle Plugin (AGP) und Gradle-Versionen (empfohlen)
7.3+	2.2.10	AGP 8.10.0 Gradle 8.11.1
6.3–7.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	Wir empfehlen die Verwendung von AGP 7.3 oder höher, da diese Version eine Problemumgehung für JDK-8272564 enthält.

Hinweis: Die oben empfohlenen AGP-Versionen berücksichtigen die Verwendung von R8/D8, das in AGP enthalten ist. Wenn Sie R8/D8 nicht verwenden, finden Sie in den Kotlin Anforderungen die Mindest- und Höchstversionen für Gradle und AGP.

Kotlin-Versionskompatibilität

Kotlin 2.2 ist abwärtskompatibel mit Kotlin 2.1. Wenn Sie also bereits Kotlin 2.1 mit dem Navigation SDK verwenden, sollten Sie auf Kotlin 2.2 aktualisieren können, ohne alle funktionsgefährdenden Änderungen beheben zu müssen. Dies gilt jedoch nur für stabile Sprach funktionen. Wenn Sie Alpha-, Beta- oder Testfunktionen in der Kotlin-Sprache verwenden, müssen Sie bei der Aktualisierung möglicherweise zusätzliche Änderungen vornehmen.

Übergang erleichtern: Kotlin-Kompatibilitätsflags

Kotlin bietet zwei Flags, mit denen Sie funktionsgefährdende Änderungen begrenzen können: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Mit diesem Flag werden funktionsgefährdende Änderungen am Verhalten einer früheren Kotlin-Version rückgängig gemacht. Wenn Sie beispielsweise Kotlin 2.1 verwenden, können Sie [ - language-version 2.1] angeben. Die neuen funktionsgefährdenden Änderungen werden dann nicht mehr wirksam:

android {
   kotlinOptions {
       languageVersion = '2.1'
   }
}

api-version X.Y

Dieses Flag löst einen Gradle-Buildfehler aus, wenn eine API aus einer Kotlin-Version verwendet wird, die neuer als die apiVersion ist.

android {
   kotlinOptions {
       apiVersion = '2.1'
   }
}

Gezielterer Ansatz

Neben der Verwendung von Kotlin-Kompatibilitätsflags empfehlen wir, die Versionshinweise zu Kotlin zu lesen und die Verhaltensweisen auszuwählen, die Sie aus der Version beibehalten möchten, von der Sie aktualisieren. Kotlin bietet in den Kompatibilitätsleitfäden für jede Version eine Liste der funktionsgefährdenden Änderungen und der Flags, die festgelegt werden können, um das ursprüngliche Verhalten beizubehalten:

• Kompatibilitätsleitfaden für 2.0
• Kompatibilitätsleitfaden für 2.1
• Kompatibilitätsleitfaden für 2.2

Zukünftige Kotlin-Upgrades

Kotlin veröffentlicht alle sechs Monate eine neue Version (d. h. eine neue Sprachversion). Google übernimmt die neueste Version in der Regel ein bis zwei Monate später als Standard in unsere Produkte. Frühere Kotlin-Versionen enthielten funktionsgefährdende Änderungen, die erforderten, dass Kunden des Navigation SDK auf eine neuere Version aktualisieren. Aus diesem Grund empfehlen wir, alle sechs Monate ein Kotlin-Upgrade zu planen, wenn Sie die neueste Version des Navigation SDK verwenden.