Jeśli używasz pakietu SDK do nawigacji na Androida w wersji 6.0 lub nowszej, musisz go uaktualnić do wersji 2.0 w języku Kotlin. Na tej stronie znajdziesz wskazówki, które ułatwią Ci przejście na nową wersję Kotlina.
Zgodność 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 SDK do nawigacji 6.0 lub nowsza
Zalecamy używanie AGP 8.3 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 obsługuje zgodność wsteczną z 3 poprzednimi wersjami języka. Oznacza to, że jeśli korzystasz już z wersji Kotlin 1.7 lub nowszej w pakiecie SDK nawigacji, powinnaś/powinieneś móc uaktualnić pakiet do wersji Kotlin 2.0 bez konieczności wprowadzania wszystkich zmian powodujących zmiany w funkcjonalności. Dotyczy to jednak tylko stabilnych wersji językowych funkcji. Jeśli używasz funkcji w wersji alfa, beta lub eksperymentalnej w języku Kotlin, podczas aktualizacji może być konieczne wprowadzenie dodatkowych zmian.
Ułatwienie przejścia: 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ą ograniczać zmiany powodujące przerwanie działania aplikacji:
language-version X.Y
Ten parametr przywraca zmiany powodujące niezgodność do zachowania poprzedniej wersji Kotlina.
Jeśli na przykład używasz Kotlina 1.7, możesz ustawić [ -
language-version 1.7], aby nowe zmiany nie miały wpływu:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version 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ć pierwotne działanie: