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.

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

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

Zgodność wersji Kotlina

Kotlin 2.1 jest zgodny wstecz z Kotlinem 2.0. Oznacza to, że jeśli używasz już Kotlina 2.0 z pakietem Navigation SDK, możesz przejść na Kotlina 2.1 bez konieczności rozwiązywania wszystkich zmian powodujących niezgodność. Dotyczy to jednak tylko stabilnych funkcji językowych. Jeśli używasz funkcji w wersji alfa, beta lub eksperymentalnych w języku Kotlin, podczas uaktualniania 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

wersja językowa X.Y

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

android {
   kotlinOptions {
       languageVersion = '2.0'
   }
}

api-version X.Y

Ten parametr powoduje błąd kompilacji Gradle, gdy używany jest interfejs API z wersji Kotlin nowszej niż apiVersion.

android {
   kotlinOptions {
       apiVersion = '2.0'
   }
}

Bardziej ukierunkowane podejście

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

Przyszłe uaktualnienia języka Kotlin

Kotlin udostępnia nową wersję (czyli wersję języka) co 6 miesięcy, a Google zwykle wprowadza najnowszą wersję jako domyślną w swoich usługach w ciągu 1–2 miesięcy. Poprzednie wersje języka Kotlin zawierały zmiany powodujące niezgodność, które wymagały od klientów korzystających z Navigation SDK przejścia na nowszą wersję. Dlatego zalecamy, aby w przypadku korzystania z najnowszej wersji pakietu Navigation SDK planować aktualizację do języka Kotlin co 6 miesięcy.