Informacje o wersji pakietu Driver SDK na Androida

Ta sekcja zawiera informacje o wersjach pakietu Driver SDK na Androida.

7.1.0 (14 maja 2026 r.)

Zmiany zależności i konfiguracji

• Dodano zależności Jetpack DataStore: androidx.datastore:datastore-core w wersji 1.1.7 i androidx.datastore:datastore-guava w wersji 1.2.0.

• Uaktualniono wersję zależności Kotlin do wersji 2.3.0.

• Zaktualizowano wtyczkę Androida do obsługi Gradle do wersji 8.13.2.

• Uaktualniono Gradle do wersji 8.13.

• Uaktualniono bibliotekę Desugar do wersji 2.1.5.

• Rozszerzyliśmy zakres obsługiwanych wersji pakietu Navigation SDK z [7.0, 7.3) na [7.0, 8.0).

wersja 7.0.0 (5 grudnia 2025 r.)

Zmiany zależności i konfiguracji

• Uaktualniono minSdkVersion do interfejsu API 26.

• Uaktualniono targetSdkVersion do API 36.

• Zaktualizowano obsługiwane wersje pakietu Navigation SDK, w tym wersje od 7.0.0.

wersja 6.99.0 (5 grudnia 2025 r.)

• Ulepszenia wewnętrzne

Ogłoszenie: wstrzymanie obsługi interfejsu API na poziomach 23, 24 i 25

Zgodnie z zasadami obsługi wersji mobilnego systemu operacyjnego wstrzymujemy obsługę Androida 6 i 7 (interfejs API na poziomie 23, 24 i 25) w nadchodzących głównych wersjach pakietu Driver SDK na Androida.

Od wersji 7.0.0 pakiet Driver SDK na Androida będzie obsługiwać co najmniej Androida 8 (poziom API 26). Starsze wersje pakietu SDK będą nadal obsługiwać Androida 6 i 7.

Jeśli zależności nie określają numeru wersji, IDE wczyta najnowszą wersję pakietu SDK, a nowe kompilacje aplikacji nie będą obsługiwać Androida 6 i 7.

Określ wersję pakietu Driver SDK na Androida w zależnościach kompilacji aplikacji, aby kontrolować, kiedy podniesiesz minimalną obsługiwaną wersję systemu operacyjnego dla nowych wersji aplikacji.

wersja 6.2.0 (18 czerwca 2025 r.)

Poprawki błędów

• Naprawiono błąd NullPointerException podczas wywoływania funkcji DriverApi.createInstance() w przypadku braku wartości DriverStatusListener.

Zmiany zależności i konfiguracji

• Od wersji 6.2.0 pakietu Driver SDK na Androida aplikacje muszą zostać zaktualizowane do wersji Kotlin 2.1.

• Zaktualizowano obsługiwane wersje pakietu Navigation SDK, w tym wersję 6.1.0 i nowsze.

Wersja 6.1.0 (10 marca 2025 r.)

Poprawki błędów

• Ulepszenia wewnętrznego rejestrowania.

Wersja 5.99.1 (10 stycznia 2025 r.)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że kierowcy otrzymywali błędy gRPC z kodem „INTERNAL” i komunikatem „Panic! This is a bug!" description on application first launch after install.

wersja 6.0.0 (25 listopada 2024 r.)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że kierowcy otrzymywali błędy gRPC z kodem „INTERNAL” i komunikatem „Panic! This is a bug!" (To jest błąd!).
• Wewnętrzne ulepszenie, które ma na celu zmniejszenie liczby błędów połączenia podczas aktualizacji lokalizacji, zwłaszcza gdy urządzenie przełącza się między sieciami. Wdrożenie będzie postępować stopniowo (od 0%) po zintegrowaniu wersji.

Aktualizacje interfejsu API

• Usunięto wycofany interfejs StatusListener.

Zmiany zależności i konfiguracji

• Usuń zależność od glide:cronet-integration w pliku POM.xml.
• Zaktualizowano obsługiwane wersje pakietu Navigation SDK do wersji 5.x.
• Od wersji 6.0.0 pakietu Driver SDK na Androida aplikacje muszą przejść na Kotlina 2.0.
• targetSdk to teraz poziom interfejsu API 34. Jest to wymagane w przypadku wszystkich aplikacji, które od sierpnia 2024 r. są wdrażane w Sklepie Google Play. Zobacz Wymagania Google Play dotyczące docelowego poziomu interfejsu API.

wersja 5.99.0 (20 września 2024 r.)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że kierowcy otrzymywali błędy gRPC z kodem „INTERNAL” i komunikatem „Panic! This is a bug!". Po zintegrowaniu wersji będzie ona wdrażana stopniowo (od 0%).
• Wewnętrzne ulepszenie mające na celu zmniejszenie liczby błędów połączenia podczas informacja o zmianie lokalizacji, zwłaszcza gdy urządzenie przełącza się między sieciami. Wdrożenie będzie postępować stopniowo (od 0%) po zintegrowaniu wersji.

Zmiany zależności i konfiguracji

• Usuń zależność od glide:cronet-integration w pliku POM.xml.

v5.0.0 (12 września 2023 r.)

Zmiany zależności i konfiguracji

• Zaktualizowano pakiet Navigation SDK do wersji 5.x.
• Zaktualizowano minSdkVersion do interfejsu API 23.
• Uaktualniono wersję języka Kotlin do 1.9.0.
• Dodano zależność od Room. * Aplikacje korzystające z pakietu Driver SDK muszą teraz mieć targetSdkVersion interfejsu API 31 lub nowszego.
• Aplikacje korzystające z pakietu Driver SDK muszą teraz mieć włączoną obsługę biblioteki Java 8. Instrukcje aktualizacji znajdziesz na stronie https://developer.android.com/studio/write/java8-support.
• Aplikacje, które korzystają z narzędzi Proguard lub Dexguard, muszą przejść na R8. Więcej informacji znajdziesz na stronie https://developer.android.com/build/shrink-code.
• Aplikacje korzystające z pakietu Driver SDK muszą mieć włączone odlukrzanie. Instrukcje znajdziesz na stronie https://developer.android.com/studio/write/java8-support#library-desugaring.

Poprawki błędów

• Rozwiązaliśmy problem z synchronizacją disableLocationTracking.
• Wprowadzono nowy interfejs DriverStatusListener, który zgłasza przyczynę w aktualizacjach stanu wyjątku.
• Rozwiązaliśmy problem z kierowcami, którzy nie ruszali się z miejsca (dostępne od wersji 4.99.0).

Wersja 4.99.0 (9 sierpnia 2023 r.)

• Obsługa różnych wersji zależności NavSDK. ** Obsługuje wersje od 4.5.0 do 5.0.0 (bez wersji 5.0.0).
• Zapobiegać samoczynnemu zmniejszaniu się szacowanego czasu dotarcia na miejsce, gdy pojazd jest nieruchomy. Ta zmiana będzie wdrażana stopniowo w ramach eksperymentu, więc nie wszyscy reklamodawcy zobaczą ją jednocześnie.

wersja 4.5.0 (12 maja 2023 r.)

• Zaktualizuj zależność pakietu Navigation SDK do wersji 4.5. Pamiętaj, że identyfikatory grupy i artefaktu pakietu Navigation SDK uległy zmianie.

Wersja 4.4.3 (20 marca 2023 r.)

Zmiana zależności

• Zaktualizuj zależność pakietu Navigation SDK do wersji 4.4.1.

Wersja 4.4.2 (15 lutego 2023 r.)

Poprawki błędów

• Skróciliśmy czas przywracania połączenia sieciowego, gdy pakiet SDK napotka tymczasowy problem z połączeniem. To jest poprawka eksperymentalna.

• Odrzucaj UpdateVehicle żądania, które zawierają tylko lokalizację „Surowa”.

• Naprawiono sytuację wyścigu w interfejsie API „Opis trasy” w wersji alfa.

wersja 4.4.1 (18 listopada 2022 r.)

Poprawki błędów

• Poprawiliśmy błąd w logice przesyłania danych o ruchu.

Dodatkowe zmiany

• Wewnętrzne ulepszenia nagłówków żądań i raportowania kodów stanu.

Wersja 4.4.0 (21 września 2022 r.)

Poprawki błędów

• Naprawiono błąd, który uniemożliwiał usunięcie powiadomienia „Jazda z Mapami Google”, jeśli instancja interfejsu API nie została wyczyszczona.

Zmiana zależności

• Zaktualizuj zależność pakietu Navigation SDK do wersji 4.2.2.

wersja 4.3.0 (24 sierpnia 2022 r.)

Ulepszenia wewnętrzne.

Ogłoszenie: wstrzymanie obsługi Androida 5 (21 lipca 2022 r.)

W przypadku najnowszej wersji pakietu SDK (v4.2.0) zapewniamy dodatkowy rok pomocy dotyczącej aplikacji działających na Androidzie 5, zarówno na poziomie API 21, jak i 22.

Co to oznacza:

• Pakiety Navigation SDK i Driver SDK działające w aplikacjach na Androida będą obsługiwać minimalną wersję Androida 5 (poziom API 21) do 30 czerwca 2023 r.
• Po 30 czerwca 2023 roku będziemy obsługiwać tylko poziomy interfejsu API Androida 23 i nowsze. Innymi słowy, po tej dacie przestaniemy obsługiwać poziomy interfejsu API Androida 21 i 22 we wszystkich wersjach pakietu SDK. Oznacza to, że błędy związane z Androidem 21 lub 22 w dowolnej wersji pakietu SDK (w tym w wersji 4.x) nie będą naprawiane i nie gwarantujemy, że pakiety SDK będą działać prawidłowo.

To powiadomienie zastępuje powiadomienie o wstrzymaniu obsługi Androida 21 i 22 z 21 czerwca 2021 r. oraz powiadomienie o wstrzymaniu obsługi Androida 23, 24 i 25 z 18 października 2021 r.

Wersja 4.2.0 (8 czerwca 2022 r.)

Zmiana zależności

• Zaktualizuj zależność pakietu Nav SDK do wersji 4.1.3.
• Obniża minimalny obsługiwany poziom interfejsu Android API do 21.

Wersja 4.1.0 (28 kwietnia 2022 r.)

Aktualizacje interfejsu API

• Zmieniliśmy nazwę właściwości parentId obiektu Task na trackingId. Stara właściwość nadal istnieje, ale jest wycofana.

wersja 4.0.0 (29 listopada 2021 r.)

Minimalny obsługiwany poziom interfejsu API Androida w tej wersji to 23.

Aktualizacje interfejsu API

W tej wersji pakietu Driver SDK na Androida wprowadziliśmy te zmiany.

Zmiana w interfejsie VehicleStops API

Obiekty VehicleStop odwołują się teraz do listy obiektów TaskInfo zamiast do listy obiektów Task. Jeśli potrzebujesz stanu zadania, możesz śledzić go w kodzie aplikacji.

• Dodano nową klasę: TaskInfo

• Funkcja getTasks w VehicleStop została zastąpiona funkcją getTaskInfoList.

• Funkcja setTasks w VehicleStop.Builder została zastąpiona funkcją setTaskInfoList.

Monitorowanie awarii

Dodaliśmy monitorowanie i raportowanie awarii, aby zwiększyć stabilność pakietu SDK. Ta funkcja jest domyślnie włączona, ale możesz ją wyłączyć, wywołując funkcję setAbnormalTerminationReportingEnabled() i przekazując jej wartość false przed zainicjowaniem pakietu SDK.

• Dodano funkcję setAbnormalTerminationReportingEnabled do DriverApi.

Asynchroniczne wywołanie getRemainingVehicleStops

• Zmieniono funkcję getRemainingVehicleStops obiektu DeliveryVehicleReporter, aby zwracała Future<List<VehicleStop>> zamiast List<VehicleStop>.

Uwierzytelnianie

Usunęliśmy niepotrzebne właściwości z interfejsu AuthTokenContext. Środowisko wykonawcze ServiceType zostało wycofane. Teraz musisz tylko uzyskać roszczenia dotyczące identyfikatora pojazdu i identyfikatora zadania, zamiast polegać na ServiceType.

• Usunięto element ServiceType z konta AuthTokenContext.

• Usunięto element getServiceType() z AuthTokenContext.

• Usunięto element setServiceType z konta AuthTokenContext.Builder.

18 października 2021 r. – wstrzymanie obsługi poziomów interfejsu API 23, 24 i 25

v3.0.4 (28 lipca 2021 r.)

Funkcje

W tej wersji pakiet Driver SDK jest oficjalnie oddzielony od pakietu Navigation SDK. Szczegółowe informacje znajdziesz w przewodniku po migracji.

Aktualizacje interfejsów API

Dodano te metody:

`RidesharingDriverApi.getDriverSdkVersion()`

Stabilność i poprawki błędów

Zgłaszaj błędy PERMISSION_DENIED zamiast klasyfikować je jako błędy połączenia.

Ogłoszenie o wycofaniu (21 czerwca 2021 r.)

To ogłoszenie dotyczy wycofania pakietu Driver SDK na Androida i pakietu Navigation SDK na Androida od daty podanej powyżej. To ogłoszenie zostało też wysłane do klientów, których dotyczy, jako obowiązkowe powiadomienie o usłudze.

Pakiet SDK do nawigacji i pakiet SDK dla kierowców na Androida staną się pakietem SDK do nawigacji na Androida w wersji 3.x i pakietem SDK dla kierowców na Androida w wersji 3.x (podzielone pliki binarne).

Aby uprościć integrację z klientami i przyspieszyć wdrażanie przydatnych funkcji, dzielimy pakiety SDK do nawigacji na Androida i SDK dla kierowców na Androida na 2 różne pliki binarne:

• Pakiet Navigation SDK na Androida, który zapewni kierowcom funkcje nawigacji i wyznaczania tras.
• Pakiet Driver SDK na Androida, który umożliwia korzystanie z usług sieciowych Fleet Engine z zachowaniem stanu na potrzeby postępów i przydzielania przejazdów lub zadań.

Pamiętaj, że pakiet SDK dla kierowców na Androida wymaga pakietu SDK do nawigacji na Androida do obsługi podstawowych funkcji wyznaczania trasy.

Jakie zmiany zostały wprowadzone?

Najważniejsze zmiany w wersji 3:

• 2 pliki binarne zamiast jednego.
• Bardziej przejrzyste definicje pakietów dla klas Driver SDK na Androida.
• Pakiet Navigation SDK na Androida zawiera pakiet Maps SDK na Androida jako część pakietu (od wersji 2).
  • Umożliwia to współistnienie funkcji map i nawigacji na tej samej mapie (np. rysowanie linii łamanych na widoku NavigationView) i zmniejsza wykorzystanie pamięci, ponieważ zamiast dwóch map używana jest jedna.
  • Pakiet SDK do nawigacji na Androida w wersji 3.0 nie ma wszystkich funkcji pakietu SDK do nawigacji na Androida, ale wersja 3.2 rozwiąże większość problemów. Więcej informacji znajdziesz w artykule Co mogę zrobić i kiedy?.
• rejestrowanie, które ułatwi nam debugowanie problemów, które możesz napotkać;

W wersji 3 usunięto też te metody, które wcześniej zostały oznaczone jako przestarzałe i dla których istnieje już alternatywne rozwiązanie:

• Te metody pakietu SDK nawigacji/kierowcy zostały wycofane w wersji 1.16, która została opublikowana 10 sierpnia 2020 r., i usunięte w wersji 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Dla zachowania kompletności i przejrzystości należy pamiętać, że podczas przejścia z wersji 1 na wersję 2 usunięto wiele metod. Większość z nich to połączenie zduplikowanych klas między pakietem Navigation SDK na Androida a pakietem Maps SDK na Androida. Aby lepiej zrozumieć te zmiany, zapoznaj się z przewodnikiem po migracji.

Wycofanie pakietu Driver SDK na Androida i pakietu Navigation SDK na Androida w wersji 1.x

Pakiet SDK Nav/Driver w wersji 1 został opublikowany w 2018 r. Wkrótce udostępnimy wersje 3, więc czas wycofać wersję 1, aby uniknąć problemów związanych z obsługą wielu wersji głównych.

Czas zaoszczędzony dzięki wycofaniu obsługi tej dodatkowej wersji pozwoli nam lepiej wspierać najnowszą wersję główną i tworzyć więcej funkcji, które są ważne dla naszych klientów.

W związku z tym pakiet SDK Nav/Driver w wersji 1.x został wycofany i po 21 czerwca 2022 r. nie będzie już utrzymywany.

Poświęć chwilę, aby dowiedzieć się, jak działa wycofywanie wersji pakietów SDK.

Koniec wsparcia dla pakietów Navigation SDK i Driver SDK na Androidzie w wersjach 21 i 22

wersja 1.15.3 (9 października 2020 r.)

Aktualizacje interfejsu API

• Pakiet SDK sterowników subskrybuje teraz pakiet SDK do nawigacji, aby otrzymywać aktualizacje o ruchu, które są wysyłane do interfejsu Fleet Engine API.

Stabilność i poprawki błędów

• Usunięto awarię środowiska wykonawczego gRPC.

v1.15.2

Funkcje

Dodaliśmy możliwość zatrzymania trwałego powiadomienia. Jeśli raportowanie lokalizacji zostanie zatrzymane w instancji Fleet Engine, wskazówki zostaną zatrzymane w Navigator, wszystkie odbiorniki nawigacji zostaną wyrejestrowane, a NavigationFragment lub NavigationView zostanie wstrzymane.

Stabilność i poprawki błędów

• Naprawiliśmy błąd, który powodował zgłaszanie wyjątku w przypadku wyczyszczenia instancji Fleet Engine.

wersja 1.15.1 (12 maja 2020 r.)

Funkcje

Wstępna analiza danych z wersji 1.15.0 wykazała znaczną poprawę w zakresie raportowania stabilnej lokalizacji (zmniejszenie liczby „zablokowanych” lokalizacji). Ta poprawka umożliwia dalsze korzystanie z ulepszonego raportowania lokalizacji. Problem z błędami ANR nie był związany z tymi ulepszeniami.

Stabilność i poprawki błędów

• Naprawiliśmy błąd, który czasami powodował wyświetlanie w aplikacji użytkownika prostej linii na początku trasy.
• Naprawiliśmy błąd, który mógł powodować błąd ANR podczas zgłaszania lokalizacji przez pakiet SDK. Wynikało to z ulepszeń onArrival(), które były podatne na rywalizację o blokadę. W pewnych okolicznościach udało nam się niezawodnie odtworzyć błędy ANR i potwierdzić, że poprawki rozwiązały problem. Zmodyfikowana aplikacja testowa do generowania błędów ANR działała przez 8 godzin bez wystąpienia błędu ANR po wprowadzeniu poprawki.

wersja 1.15.0 (23 marca 2019 r.)

Funkcje

• Wprowadziliśmy stan wskazówek nawigacyjnych przy rozpoczęciu, zboczeniu z trasy i przybyciu, aby ulepszyć śledzenie lokalizacji pojazdu.
• Dodaliśmy możliwość dalszego otrzymywania lokalizacji przyciąganych do dróg niezależnie od stanu nawigacji.
• Dodaliśmy dodatkowe informacje o lokalizacjach przed dopasowaniem do drogi, np. dokładność.

Stabilność i poprawki błędów

• Zwiększyliśmy wartość minSdkVersion dla pakietu navsdk do 19.
• Rozwiązaliśmy błąd, który powodował, że nazwy punktów pośrednich lat/lng nie były uwzględniane, gdy nie powiodło się odwrotne geokodowanie po stronie serwera.

Wersja 1.14.2 (2 lutego 2019 r.)

Funkcje

• Zapobiega wysyłaniu przez pakiet DriverSDK lokalizacji 0,0 do Fleet Engine (lepsze udostępnianie przejazdu i dane wejściowe lokalizacji przydzielania).
• Dodatkowe logowanie w celu rozwiązywania problemów z zablokowaną lokalizacją i zmniejszenia liczby przypadków korzystania z funkcji zastępczych podczas udostępniania przejazdu.
• Ignoruj powtarzające się wywołania metody setLocationReportingInterval(), chyba że interwał się zmieni.
• Zaktualizowano dokumentację Javadoc dla metody setReportingInterval(), aby zniechęcić do jej częstego wywoływania w krótkich odstępach czasu w porównaniu z używanymi interwałami.
• Poprawiliśmy niezawodność lokalizacji w API 29.

v1.13.0

Stabilność i poprawki błędów

• Dodaje zależność od okhttp, którą klienci będą musieli dodać do swoich kompilacji Gradle.

Wersja 1.11.7 (18 października 2019 r.)

Stabilność i poprawki błędów

• Informacje o zmianie lokalizacji są teraz kontynuowane po uruchomieniu zdarzenia onArrival() dla danego miejsca docelowego.
• Domyślne powiadomienie (stały ciąg znaków w trybie swobodnej nawigacji) jest zgodne ze schematem kolorów ustawionym dla powiadomień nawigacyjnych. Więcej informacji znajdziesz w sekcji Udostępnione trwałe powiadomienia.
• Rozwiązaliśmy problem, w którym opóźnione zdarzenie informacji o zmianie lokalizacji mogło powodować fałszywą informację o zmianie lokalizacji, co prowadziło do artefaktów, takich jak prosta linia na początku trasy.

wersja 1.11.6 (4 października 2019 r.)

Aktualizacje interfejsu API

• Wprowadziliśmy szereg zmian, które zapewniają, że pakiet SDK kierowcy szybko wznawia aktualizacje lokalizacji po awarii sieci. Po przywróceniu połączenia sieciowego informacje o zmianie lokalizacji zaczną być ponownie wysyłane zgodnie z harmonogramem.

Stabilność i poprawki błędów

• setVehicleState() zwraca teraz wynik natychmiast. Aktualizacja FleetEngine odbywa się teraz w tle. Rozwiązuje problem z błędem „Aplikacja nie odpowiada” (ANR).
• Rozwiązaliśmy problem, który powodował, że trasy udostępniania przejazdu były wyświetlane jako linia prosta w starszych wersjach pakietu Consumer SDK. Gwarantuje, że pakiet Driver SDK nie dodaje do trasy jednorazowych punktów pośrednich.