Migracja do interfejsu DriverStatusListener
W wersji 5 aplikacji Driver ogłosiliśmy wycofanie interfejsu StatusListener na rzecz DriverStatusListener. W tym roku oficjalnie usuwamy interfejs StatusListener. Aby uzyskać informacje o przewodniku po migracji do nowego interfejsu, zapoznaj się z artykułem o wycofaniu StatusListener.
Migracja do Kotlina 2.0
Jeśli używasz pakietu Driver SDK 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ę Kotlina.
Zgodność Gradle i AGP
Kotlin 2.0 ma wymagania dotyczące minimalnej i maksymalnej wersji Gradle oraz wtyczki Androida do obsługi Gradle (AGP). Upewnij się, że Twój projekt spełnia te wymagania dotyczące Kotlina 2.0.
Minimalna wersja AGP dla pakietu Driver SDK 6.0 lub nowszej
Zalecamy używanie AGP 7.3 lub nowszej wersji z Driver SDK 6.0.
Tryb pełnego R8
Pakiet Driver SDK w wersji 6 i starszych nie obsługuje trybu pełnego R8. Jeśli Twoja aplikacja jest kierowana na AGP 8.0 lub nowszą, musisz wyraźnie wyłączyć tryb Full R8.
# settings.gradle
android.enableR8.fullMode=false
Zgodność z wersjami Kotlina
Kotlin obsługuje zgodność wsteczną z 3 poprzednimi wersjami języka. Oznacza to, że jeśli używasz już Kotlina w wersji 1.7 lub nowszej z Driver SDK, powinna Ci się udać aktualizacja do Kotlina 2.0 bez konieczności wprowadzania wszystkich zmian. Zgodność z Kotlinem dotyczy tylko stabilnych funkcji 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.
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
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ć oryginalne działanie.