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 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.

Version des Navigation SDK	Kotlin-Version (erforderlich)	Versionen des Android-Gradle-Plug-ins (AGP) und von Gradle (empfohlen)
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	Wir empfehlen die Verwendung von AGP 7.3 oder höher, da dort ein Workaround für JDK-8272564 enthalten ist.

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

.

Kompatibilität mit Kotlin-Versionen

Kotlin 2.1 unterstützt die Abwärtskompatibilität mit Kotlin 2.0. Wenn Sie Kotlin 2.0 bereits mit dem Navigation SDK verwenden, sollten Sie also auf Kotlin 2.1 aktualisieren können, ohne alle Breaking Changes 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.

Übergang erleichtern: Kotlin-Kompatibilitäts-Flags

Kotlin bietet zwei Flags, mit denen sich Breaking Changes einschränken lassen: https://kotlinlang.org/docs/compatibility-modes.html

Sprachversion X.Y

Mit diesem Flag werden Breaking Changes am Verhalten einer früheren Kotlin-Version rückgängig gemacht. Wenn Sie beispielsweise Kotlin 2.0 verwenden, können Sie [ - language-version 2.0] angeben. Die neuen Breaking Changes werden dann nicht mehr angewendet:

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

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.0'
   }
}

Gezielterer Ansatz

Zusätzlich zur Verwendung von Kotlin-Kompatibilitätsflags 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 eine Liste der Breaking Changes und der Flags, die festgelegt werden können, um das ursprüngliche Verhalten in den Kompatibilitätsleitfäden für jede Version beizubehalten:

• Kompatibilitätsleitfaden für Version 1.9
• Kompatibilitätsleitfaden für Version 2.0
• 2.1 Kompatibilitätsleitfaden

Zukünftige Kotlin-Upgrades

Kotlin veröffentlicht alle 6 Monate eine neue Version (d. h. einen Sprachrelease). Google verwendet die neueste Version in der Regel 1–2 Monate später als Standard in unseren Produkten. Frühere Kotlin-Versionen enthielten wichtige Änderungen, die ein Upgrade auf eine neuere Version für Navigation SDK-Kunden erforderlich machten. Daher empfehlen wir, alle sechs Monate ein Kotlin-Upgrade durchzuführen, wenn Sie die neueste Version des Navigation SDK verwenden.