Przewodnik po migracji pakietu SDK sterownika na Androida w wersji 6.0

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. Więcej informacji o migracji do nowego interfejsu znajdziesz w artykule o wycofaniu StatusListener.

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 Kotlina

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, Kotlin obsługuje podczas uaktualniania maksymalnie 3 poprzednie wersje języka. Kotlin udostępnia 2 flagi, które pomagają ograniczyć zmiany powodujące niezgodność:

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

Ta flaga zapobiega używaniu nowych interfejsów API, zanim zależny kod podrzędny będzie gotowy do obsługi Kotlina 2.0.

android {
   kotlinOptions {
       apiVersion = '1.7'
   }
}

Bardziej ukierunkowane podejście

Oprócz używania flag zgodności Kotlina zalecamy zapoznanie się z informacjami o wersji Kotlina i wybranie zachowań, które chcesz zachować z wersji, z której przeprowadzasz uaktualnienie. 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: