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)
7,3+ 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 wtyczki Androida do obsługi Gradle w wersji 7.3 lub nowszej, która zawiera obejście problemu JDK-8272564.
Kotlina w przypadku Gradle i AGP.

Zgodność wersji języka Kotlin

Kotlin 2.2 obsługuje zgodność wsteczną 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ę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

language-version X.Y

Ten flag przywraca zmiany powodujące niezgodność do zachowania z poprzedniej wersji języka Kotlin. Jeśli na przykład używasz Kotlin 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

Ten parametr powoduje błąd kompilacji Gradle, gdy używany jest interfejs API z wersji 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 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 zgodności dla każdej wersji:

Przyszłe uaktualnienia Kotlina

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 od jej udostępnienia. 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 planowanie aktualizacji języka Kotlin co 6 miesięcy w przypadku wdrażania najnowszej wersji pakietu Navigation SDK.