Zgodność z wersją i migracja w Kotlinie

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

Wymagania dotyczące wersji Kotlina w Navigation SDK

W tabeli poniżej znajdziesz wymagania dotyczące wersji Kotlina oraz zalecane wersje AGP i Gradle w przypadku najnowszych wersji Navigation SDK.

Wersja Navigation SDK	Wersja Kotlina (wymagana)	Wersje wtyczki Androida do obsługi Gradle (AGP) i Gradle (zalecane)
7.7 lub nowsza	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	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 Kotlina w zakresie minimalnych i maksymalnych wersji Gradle i AGP.

Zgodność wersji Kotlina

Kotlin 2.3 jest wstecznie zgodny z Kotlinem 2.2. Oznacza to, że jeśli używasz już Kotlina 2.2 z Navigation SDK, możesz przejść na Kotlina 2.3 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 Kotlina

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 Kotlina. Jeśli na przykład używasz Kotlina 2.2, możesz określić [ - language-version 2.2], a nowe zmiany powodujące niezgodność nie będą już obowiązywać:

android {
   kotlinOptions {
       languageVersion = '2.2'
   }
}

api-version X.Y

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

android {
   kotlinOptions {
       apiVersion = '2.2'
   }
}

Bardziej ukierunkowane podejście

Oprócz używania flag zgodności Kotlina zalecamy zapoznanie się z informacjami o wersji Kotlina i wybranie zachowań, które chcesz zachować z wersji, z której dokonujesz aktualizacji. Kotlin udostępnia listę zmian powodujących niezgodność oraz flag, które można ustawić, aby zachować pierwotne 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
• Przewodnik zgodności z wersją 2.3

Przyszłe aktualizacje Kotlina

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 Kotlina zawierały zmiany powodujące niezgodność, które wymagały od klientów Navigation SDK przejścia na nowszą wersję. Z tego powodu zalecamy, aby co 6 miesięcy planować aktualizację Kotlina podczas wdrażania najnowszej wersji Navigation SDK.