Jeśli używasz pakietu SDK do nawigacji na Androida w wersji 6.0 lub nowszej, musisz go uaktualnić do wersji Kotlin 2.0. Na tej stronie znajdziesz wskazówki, które ułatwią Ci przejście na nową wersję Kotlin.
Zgodność z narzędziami Gradle i AGP
Kotlin 2.0 ma wymagania dotyczące minimalnej i maksymalnej wersji Gradle i wtyczki Androida Gradle (AGP). Upewnij się, że Twój projekt spełnia te wymagania dotyczące Kotlina 2.0.
Minimalna wersja AGP dla pakietu Navigation SDK 6.0 lub nowszej
Zalecamy używanie AGP 7.3 lub nowszej wersji z pakietem SDK nawigacji 6.0. Zweryfikowaliśmy pakiet SDK z AGP 8.3 i Gradle 8.4. Pakiet SDK jest zgodny z trybem pełnym R8.
Zgodność z wersją Kotlina
Kotlin zapewnia zgodność wsteczną z 3 wcześniejszymi wersjami językowymi. Oznacza to, że jeśli korzystasz już z Kotlin 1.7 lub nowszego z pakietem Navigation SDK, powinno być możliwe uaktualnienie do wersji Kotlin 2.0 bez konieczności poprawiania wszystkich zmian powodujących niezgodność. Dotyczy to jednak tylko stabilnych wersji językowych. Jeśli używasz funkcji w wersji alfa, beta lub eksperymentalnej w języku Kotlin, podczas aktualizacji może być konieczne wprowadzenie dodatkowych zmian.
Łatwe przejście: flagi zgodności z Kotlinem
Jak wspomniano w poprzedniej sekcji, Kotlin obsługuje do 3 poprzednich wersji języka podczas aktualizacji. Kotlin zawiera 2 flagi, które pomagają ograniczyć zmiany powodujące przerwanie działania aplikacji:
language-version X.Y
Ta flaga przywraca zmiany powodujące niezgodność w działaniu poprzedniej wersji Kotlin.
Jeśli na przykład używasz Kotlin 1.7, możesz określić [ -
language-version 1.7], co spowoduje, że nowe zmiany powodujące niezgodność przestaną obowiązywać:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
wersja interfejsu API X.Y
Ten parametr uniemożliwia używanie nowych interfejsów API, dopóki zależny kod podrzędny nie będzie gotowy do włączenia Kotlina 2.0.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
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 języka Kotlin znajdziesz listę zmian, które mogą spowodować przerwanie działania aplikacji, oraz flagi, które można ustawić, aby zachować oryginalne działanie: