Migracja do interfejsu DriverStatusListener
W wersji 5 sterownika ogłosiliśmy wycofanie interfejsu StatusListener na rzecz interfejsu DriverStatusListener. W tym roku oficjalnie usuwamy interfejs StatusListener. W StatusListenerartykule o wycofaniu znajdziesz przewodnik po migracji do nowego interfejsu.
Migracja do Kotlin 2.0
Jeśli używasz pakietu Driver SDK na Androida 6.0 lub nowszego, musisz przejść na Kotlin 2.0. Na tej stronie znajdziesz wskazówki, które ułatwią przejście na nową wersję języka Kotlin.
Zgodność Gradle i AGP
Kotlin 2.0 ma wymagania dotyczące minimalnej i maksymalnej wersji Gradle i wtyczki Androida do obsługi Gradle (AGP). Sprawdź, czy Twój projekt spełnia te wymagania dotyczące języka Kotlin 2.0.
Minimalna wersja AGP dla pakietu Driver SDK w wersji 6.0 lub nowszej
Zalecamy używanie wtyczki AGP w wersji 7.3 lub nowszej z pakietem Driver SDK w wersji 6.0.
Pełny tryb R8
Pakiet Driver SDK w wersji 6 i starszych nie obsługuje trybu Full R8. Jeśli Twoja aplikacja jest kierowana na wtyczkę Androida do obsługi Gradle w wersji 8.0 lub nowszej, musisz wyraźnie wyłączyć tryb pełny R8.
# settings.gradle
android.enableR8.fullMode=false
Zgodność wersji języka Kotlin
Kotlin obsługuje zgodność wsteczną z 3 poprzednimi wersjami języka. Oznacza to, że jeśli używasz już języka Kotlin w wersji 1.7 lub nowszej z pakietem Driver SDK, powinna być możliwa aktualizacja do wersji 2.0 bez konieczności rozwiązywania wszystkich zmian powodujących niezgodność. Zgodność z Kotlinem dotyczy jednak tylko stabilnych funkcji języka. Jeśli używasz w języku Kotlin funkcji w wersji alfa, beta lub eksperymentalnej, podczas uaktualniania może być konieczne wprowadzenie dodatkowych zmian.
Flagi zgodności z Kotlinem
Jak wspomnieliśmy w poprzedniej sekcji, podczas uaktualniania Kotlin obsługuje do 3 poprzednich wersji języka. Kotlin udostępnia 2 flagi, które pomagają ograniczać zmiany powodujące problemy:
wersja języka 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 1.7, możesz określić [ -
language-version 1.7], a nowe zmiany powodujące niezgodność nie będą już obowiązywać:
android {
kotlinOptions {
languageVersion = '1.7'
}
}
api-version X.Y
Ten flag uniemożliwia używanie nowych interfejsów API, zanim zależny kod podrzędny będzie gotowy do włączenia Kotlina 2.0.
android {
kotlinOptions {
apiVersion = '1.7'
}
}
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: