Kotlin-Versionskompatibilität und -Migration

Auf dieser Seite finden Sie Informationen zur Kompatibilität von Kotlin-Versionen mit dem Navigation SDK sowie eine Anleitung zur Migration zu einer neueren Version.

Anforderungen an die Kotlin-Version des Navigation SDK

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

Navigation SDK-Version	Kotlin-Version (erforderlich)	Android-Gradle-Plug-in (AGP) und Gradle-Versionen (empfohlen)
8.0+	2.3.0	AGP 9.0.1 Gradle 9.1.0 Wichtig:Für das Navigation SDK 8.0 und höher ist AGP 9.0.1 eine Mindestanforderung und keine Empfehlung. Das SDK deklariert minAndroidGradlePluginVersion=9.0.1 und Builds mit einer früheren Version von AGP schlagen fehl.
7.7–7.9	2.3.0	AGP 8.13.2 Gradle 8.13
7.3–7.6	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 es eine Problemumgehung für JDK-8272564 enthält.

Hinweis: Die oben aufgeführten empfohlenen AGP-Versionen berücksichtigen die Verwendung von R8/D8, das im 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.3 ist abwärtskompatibel mit Kotlin 2.2. Wenn Sie also bereits Kotlin 2.2 mit dem Navigation SDK verwenden, sollten Sie ein Upgrade auf Kotlin 2.3 durchführen können, ohne alle funktionsgefährdenden Änderungen beheben zu müssen. Dies gilt jedoch nur für stabile Sprachfunktionen. Wenn Sie Alpha-, Beta- oder experimentelle Funktionen in der Kotlin-Sprache verwenden, müssen Sie beim Upgrade möglicherweise zusätzliche Änderungen vornehmen.

Erleichterung des Übergangs: Kotlin-Kompatibilitäts-Flags

Kotlin bietet zwei Flags, mit denen sich funktionsgefährdende Änderungen einschränken lassen: 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.2 verwenden, können Sie [ - language-version 2.2] angeben. Die neuen funktionsgefährdenden Änderungen werden dann nicht mehr wirksam:

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

Ein gezielterer Ansatz

Zusätzlich zur Verwendung von Kotlin-Kompatibilitäts-Flags empfehlen wir, die Kotlin-Versionshinweise zu lesen und die Verhaltensweisen auszuwählen, die Sie aus der Version beibehalten möchten, von der Sie ein Upgrade durchführen. 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:

• Leitfaden zur Kompatibilität mit Version 2.0
• 2.1 Kompatibilitätsleitfaden
• Kompatibilitätsleitfaden für Version 2.2
• Kompatibilitätsleitfaden für Version 2.3

Zukünftige Kotlin-Upgrades

Kotlin veröffentlicht alle 6 Monate eine neue Version (d.h. ein Sprachrelease) und Google integriert die neueste Version in der Regel 1–2 Monate später als Standardversion in unsere Produkte. Frühere Kotlin-Versionen enthielten funktionsgefährdende Änderungen, die dazu führten, dass Kunden des Navigation SDK ein Upgrade auf eine neuere Version durchführen mussten. Daher empfehlen wir, bei der Einführung der neuesten Navigation SDK-Version alle 6 Monate ein Kotlin-Upgrade einzuplanen.