Na tej stronie znajdziesz informacje o kompatibilności wersji Kotlina z pakietem SDK nawigacji oraz wskazówki dotyczące migracji do nowszej wersji.
Wymagania dotyczące wersji pakietu SDK nawigacji w języku Kotlin
W tabeli poniżej znajdziesz wymagania dotyczące wersji Kotlina oraz zalecane wersje AGPL i Gradle w przypadku najnowszych wersji pakietu SDK Nawigacji.
| Wersja pakietu SDK do nawigacji | Wersja Kotlina (wymagane) | Wtyczka Androida do obsługi Gradle (AGP) i wersje Gradle (zalecane) |
|---|---|---|
| 6,2+ | 2.1 |
|
| 6.0–6.2 | 2,0 |
|
| 5.1–5.99.1 | 1.9 | Zalecamy użycie AGP 7.3 lub nowszej wersji, która zawiera obejście problemu JDK-8272564. |
Zgodność z wersją Kotlina
Kotlin 2.1 jest zgodny wstecz z Kotlinem 2.0. Oznacza to, że jeśli korzystasz już z Kotlina 2.0 w pakiecie SDK nawigacji, możesz uaktualnić go do wersji 2.1 bez konieczności rozwiązywania wszystkich zmian powodujących przerwanie działania. Dotyczy to jednak tylko funkcji języka stabilnego. Jeśli używasz funkcji w wersji alfa, beta lub eksperymentalnej w języku Kotlin, podczas aktualizacji może być konieczne wprowadzenie dodatkowych zmian.
Łatwy proces przejścia: flagi zgodności z Kotlinem
Kotlin udostępnia 2 flagi, które pomagają ograniczyć zmiany powodujące błędy: https://kotlinlang.org/docs/compatibility-modes.html
language-version X.Y
Ten parametr przywraca zmiany powodujące niezgodność do zachowania poprzedniej wersji Kotlina.
Jeśli na przykład używasz Kotlina 2.0, możesz ustawić [ -
language-version 2.0], aby nowe zmiany nie miały wpływu:
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 flag zgodności Kotlina zalecamy zapoznanie się z notatkami o wersji Kotlina i wybranie zachowanych zachowań z wersji, z której przeprowadzasz uaktualnienie. W przewodnikach dotyczących zgodności w poszczególnych wersjach Kotlina znajdziesz listę zmian, które powodują przerwanie działania aplikacji, oraz flagi, które można ustawić, aby zachować oryginalne działanie.
Przyszłe uaktualnienia Kotlina
Kotlin udostępnia nową wersję (tj. wersję językową) co 6 miesięcy, a Google zwykle wprowadza najnowszą wersję jako domyślną w naszych usługach po 1–2 miesięcach. W poprzednich wersjach Kotlina był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 po przyjęciu najnowszej wersji pakietu SDK nawigacji co 6 miesięcy planować uaktualnienie Kotlina.