Informacje o wersji pakietu Driver SDK na Androida

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

Ogłoszenie: wstrzymanie obsługi poziomów API 23, 24 i 25

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

Wersje pakietu Driver SDK na Androida wydane od czwartego kwartału 2025 r. będą 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 podnosisz 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 parametru DriverStatusListener.

Zmiany zależności i konfiguracji

• Od wersji 6.2.0 pakietu Driver SDK na Androida aplikacje muszą być aktualizowane do 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

• Wewnętrzne ulepszenia logowania.

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! To błąd!” przy pierwszym uruchomieniu aplikacji po zainstalowaniu.

wersja 6.0.0 (25 listopada 2024 r.)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował wyświetlanie kierowcom błędów gRPC z kodem „INTERNAL” i komunikatem „Panic! This is a bug!".
• Wewnętrzne ulepszenie, które ma na celu ograniczenie 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 interfejsów 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 język Kotlin 2.0.
• targetSdk to teraz poziom 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, który powodował wyświetlanie kierowcom błędów 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, które ma na celu ograniczenie 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.

Zmiany zależności i konfiguracji

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

5.0.0 (12 września 2023 r.)

Zmiany zależności i konfiguracji

• Zaktualizowaliśmy pakiet Navigation SDK do wersji 5.x.
• Uaktualniono minSdkVersion do interfejsu API 23.
• Uaktualniono Kotlin do wersji 1.9.0.
• Dodano zależność od Room. * Aplikacje korzystające z pakietu Driver SDK muszą teraz mieć targetSdkVersion interfejsu API w wersji 31 lub nowszej.
• Aplikacje korzystające z pakietu Driver SDK muszą teraz włączyć 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 odcukrzanie. Instrukcje znajdziesz na stronie https://developer.android.com/studio/write/java8-support#library-desugaring.

Poprawki błędów

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

v4.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).
• Zapobiegaj samoczynnemu zmniejszaniu się szacowanego czasu przyjazdu, gdy pojazd jest nieruchomy. Ta zmiana jest wprowadzana stopniowo w ramach eksperymentu, więc nie wszystkie aplikacje będą widzieć 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

• Uaktualnij 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 SDK napotka tymczasowy problem z połączeniem. Jest to eksperymentalna poprawka.

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

• Naprawiono wyścig w interfejsie API „Opis trasy” w wersji alfa.

wersja 4.4.1 (18 listopada 2022 r.)

Poprawki błędów

• Naprawiliś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

• Rozwiązaliśmy błąd, który uniemożliwiał usunięcie powiadomienia „Prowadzenie 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 (4.2.0) zapewniamy dodatkowy rok obsługi aplikacji działających na Androidzie 5, zarówno w przypadku interfejsu API na poziomie 21, jak i 22.

Co to oznacza:

• Pakiety SDK Navigation i Driver 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 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 zostaną naprawione 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.

4.2.0 (8 czerwca 2022 r.)

Zmiana zależności

• Uaktualnij 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 interfejsów API

• Zmieniliśmy nazwę właściwości parentId obiektu Task na trackingId. Stara usługa 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 interfejsów 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, śledź go w kodzie aplikacji.

• Dodaliśmy nową klasę: TaskInfo

• Zastąpiliśmy funkcję getTasks użytkownika VehicleStop funkcją getTaskInfoList.

• Funkcja setTasks użytkownika 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ę Changed DeliveryVehicleReporter's getRemainingVehicleStops, aby zwracała Future<List<VehicleStop>> zamiast List<VehicleStop>.

Uwierzytelnianie

Usunęliśmy niepotrzebne usługi z interfejsu AuthTokenContext. ServiceType zostało wycofane. Teraz musisz tylko uzyskać roszczenia dotyczące identyfikatora pojazdu i identyfikatora zadania, zamiast polegać na ServiceType.

• Usunięto ServiceType z konta AuthTokenContext.

• Usunięto getServiceType() z konta AuthTokenContext.

• Usunięto setServiceType z konta AuthTokenContext.Builder.

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

wersja 3.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.)

W tym ogłoszeniu opisujemy wycofanie pakietu Driver SDK na Androida i pakietu Navigation SDK na Androida z datą podaną powyżej. To ogłoszenie zostało również wysłane do klientów, których dotyczy problem, jako obowiązkowe powiadomienie o usłudze.

Pakiet Nav/Driver SDK na Androida zostanie podzielony na pakiety Navigation SDK na Androida w wersji 3.x i Driver SDK na Androida w wersji 3.x (osobne 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 SDK do nawigacji na Androida, który zapewni kierowcom funkcje nawigacji i wyznaczania tras.
• Pakiet Driver SDK na Androida, który umożliwia korzystanie z usług internetowych Fleet Engine z zachowaniem stanu na potrzeby postępu i przydzielania podróży lub zadań.

Pamiętaj, że pakiet Driver SDK na Androida wymaga pakietu Navigation SDK na Androida do obsługi podstawowych funkcji wyznaczania trasy.

Jakie zmiany zostały wprowadzone?

Główne zmiany w wersji 3:

• 2 pliki binarne zamiast 1.
• Bardziej przejrzyste definicje pakietów dla klas pakietu 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 polilinii na widoku NavigationView) i zmniejsza zużycie pamięci, ponieważ zamiast dwóch map używana jest jedna.
  • Pakiet Navigation SDK na Androida w wersji 3.0 nie ma wszystkich funkcji pakietu Navigation SDK 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, jakie 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 do nawigacji i pakietu SDK dla kierowców zostały wycofane w wersji 1.16 opublikowanej 10 sierpnia 2020 r. i usunięte w wersji 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Dla jasności i kompletności informacji warto zauważyć, że w przejściu z wersji 1 na wersję 2 usunięto kilka metod. Większość z nich to połączenie zduplikowanych klas między pakietem SDK do nawigacji na Androida a pakietem SDK Map Google na Androida. Więcej informacji o tych zmianach znajdziesz w przewodniku po migracji.

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

Pakiet Nav/Driver SDK w wersji 1 został opublikowany w 2018 r. Wkrótce udostępnimy wersje 3, więc nadszedł czas, aby wycofać wersję 1. Dzięki temu unikniemy 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 obsługiwać najnowszą wersję główną i tworzyć więcej funkcji ważnych dla naszych klientów.

Wersja 1.x pakietu Nav/Driver SDK została wycofana i po 21 czerwca 2022 r. nie będzie już utrzymywana.

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

Zakończenie obsługi pakietów Navigation SDK i Driver SDK na Androida w wersjach 21 i 22

wersja 1.15.3 (9 października 2020 r.)

Aktualizacje interfejsów API

• Pakiet Driver SDK subskrybuje teraz pakiet Navigation SDK w celu otrzymywania aktualizacji o ruchu, które są wysyłane do interfejsu Fleet Engine API.

Stabilność i poprawki błędów

• Naprawiliśmy błąd działania 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 stabilnego raportowania lokalizacji (zmniejszenie liczby „zablokowanych” lokalizacji). Ta poprawka umożliwia dalsze korzystanie z ulepszonego raportowania lokalizacji. Problem z błędem 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 dla konsumentów linii prostej na początku trasy.
• Naprawiliśmy błąd, który mógł powodować błąd ANR podczas zgłaszania lokalizacji przez pakiet SDK. Wynika to z ulepszeń onArrival(), które były podatne na spory o blokady. 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 w zdarzeniach rozpoczęcia, zjazdu z trasy i przyjazdu, aby poprawić śledzenie lokalizacji pojazdu.
• Dodaliśmy możliwość dalszego uzyskiwania 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ększono wartość parametru minSdkVersion dla pakietu SDK do nawigacji do 19.
• Naprawiliśmy błąd, który powodował, że nazwy punktów pośrednich lat/lng nie były uwzględniane, gdy nie powiodło się geokodowanie zwrotne po stronie serwera.

Wersja 1.14.2 (2 lutego 2019 r.)

Funkcje

• Zapobiega wysyłaniu przez DriverSDK lokalizacji 0,0 do Fleet Engine (lepsze udostępnianie przejazdu i dane wejściowe lokalizacji przydziału).
• Dodatkowe rejestrowanie, które pomaga rozwiązywać problemy z zablokowaną lokalizacją i ogranicza powroty do poprzednich wersji w przypadku udostępniania trasy.
• Ignoruj powtarzające się wywołania funkcji setLocationReportingInterval(), chyba że zmieni się interwał.
• Zaktualizowano dokumentację Javadoc metody setReportingInterval(), aby zniechęcić do jej częstego wywoływania w krótkich odstępach czasu.
• Poprawiono 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

• Aktualizacje lokalizacji są teraz kontynuowane po wywołaniu zdarzenia onArrival() w przypadku 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 artykule Udostępnione trwałe powiadomienia.
• Rozwiązaliśmy problem, w którym opóźnione zdarzenie aktualizacji lokalizacji mogło powodować fałszywą aktualizację 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 interfejsów API

• Wprowadziliśmy szereg zmian, które zapewniają, że pakiet SDK kierowcy szybko wznawia aktualizacje lokalizacji po awarii sieci. Po przywróceniu połączenia z siecią aktualizacje lokalizacji zostaną wznowione podczas następnej zaplanowanej aktualizacji.

Stabilność i poprawki błędów

• setVehicleState() zwraca teraz wynik natychmiast. Aktualizowanie FleetEngine odbywa się teraz na wątku w tle. Rozwiązuje problem z błędem ANR (aplikacja nie odpowiada).
• 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 doda do trasy żadnych jednorazowych punktów pośrednich.