Zgodność z wersją i migracja w Kotlinie

Na tej stronie znajdziesz informacje o zgodności wersji języka Kotlin z pakietem Navigation SDK oraz wskazówki dotyczące migracji do nowszej wersji.

Wymagania dotyczące wersji języka Kotlin w pakiecie Navigation SDK

W tabeli poniżej znajdziesz wymagania dotyczące wersji języka Kotlin oraz zalecane wersje AGP i Gradle w przypadku najnowszych wersji pakietu Navigation SDK.

Wersja pakietu Navigation SDK	Wersja języka Kotlin (wymagana)	Wersje wtyczki Androida do obsługi Gradle (AGP) i Gradle (zalecane)
7.3 lub nowsza	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	Zalecamy używanie AGP w wersji 7.3 lub nowszej, która zawiera obejście problemu JDK-8272564.

Uwaga: zalecane wersje AGP wymienione powyżej uwzględniają użycie R8/D8, które są dołączone do AGP. Jeśli nie używasz R8/D8, zapoznaj się z wymaganiami dotyczącymi języka Kotlin w zakresie minimalnych i maksymalnych wersji Gradle i AGP.

Zgodność wersji języka Kotlin

Kotlin 2.2 jest wstecznie zgodny z Kotlinem 2.1. Oznacza to, że jeśli używasz już Kotlina 2.1 z pakietem Navigation SDK, możesz przejść na Kotlina 2.2 bez konieczności rozwiązywania wszystkich zmian powodujących niezgodność. Dotyczy to jednak tylko stabilnych funkcji języka. Jeśli używasz funkcji alfa, beta lub eksperymentalnych w języku Kotlin, podczas aktualizacji może być konieczne wprowadzenie dodatkowych zmian.

Ułatwianie przejścia: flagi zgodności z Kotlinem

Kotlin udostępnia 2 flagi, które pomagają ograniczyć zmiany powodujące niezgodność: https://kotlinlang.org/docs/compatibility-modes.html

language-version X.Y

Ta flaga przywraca zmiany powodujące niezgodność do zachowania poprzedniej wersji języka Kotlin. Jeśli na przykład używasz Kotlina 2.1, możesz określić [ - language-version 2.1], a nowe zmiany powodujące niezgodność nie będą już obowiązywać:

android {
   kotlinOptions {
       languageVersion = '2.1'
   }
}

api-version X.Y

Ta flaga powoduje błąd kompilacji Gradle, gdy używane jest API z wersji języka Kotlin nowszej niż apiVersion.

android {
   kotlinOptions {
       apiVersion = '2.1'
   }
}

Bardziej ukierunkowane podejście

Oprócz używania flag zgodności z Kotlinem zalecamy zapoznanie się z informacjami o wersji języka Kotlin i wybranie zachowań, które chcesz zachować z wersji, z której dokonujesz aktualizacji. Kotlin udostępnia listę zmian powodujących niezgodność oraz flagi, które można ustawić, aby zachować oryginalne zachowanie w przewodnikach zgodności dla każdej wersji:

• Przewodnik zgodności z wersją 2.0
• Przewodnik zgodności z wersją 2.1
• Przewodnik zgodności z wersją 2.2

Przyszłe aktualizacje języka Kotlin

Kotlin publikuje nową wersję (czyli wersję języka) co 6 miesięcy , a Google zwykle wprowadza najnowszą wersję jako domyślną w swoich usługach 1–2 miesiące później. Poprzednie wersje języka Kotlin zawierały zmiany powodujące niezgodność, które wymagały od klientów korzystających z pakietu Navigation SDK przejścia na nowszą wersję. Z tego powodu zalecamy, aby co 6 miesięcy planować aktualizację języka Kotlin podczas wdrażania najnowszej wersji pakietu Navigation SDK.