Informacje o wersji pakietu Driver SDK na Androida

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

v7.99.0 (11 listopada 2026 r.)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że próby bezpiecznego połączenia z Fleet Engine mogły pozostawać w stanie oczekiwania w nieskończoność, jeśli pośredni serwer proxy operatora zawiesił się podczas konfigurowania połączenia, co uniemożliwiało odświeżanie stanu przejazdu i aktualizacji śledzenia pojazdu w niektórych sieciach komórkowych. Pakiet Driver SDK wymusza teraz limit czasu połączenia i automatycznie przywraca połączenie po nawiązaniu nowego.

• Naprawiliśmy wycieki wątków i wykonawców podczas wywoływania DriverApi.clearInstance() (wykonawcy FleetEngineEventHandler, FusedLocationWriter i DriverApi).

Zmiany zależności i konfiguracji

• Zaktualizowaliśmy zależności Jetpack DataStore (androidx.datastore:datastore-core i androidx.datastore:datastore-guava) do wersji 1.2.1.

• Zaktualizowano wersję zależności Kotlin do wersji 2.4.0.

• Zaktualizowano zakres obsługiwanych wersji pakietu Navigation SDK do [7.9.0, 8.0.0).

Wersja 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.

• Zaktualizowano 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.

• Rozszerzono 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

• Zaktualizowano minSdkVersion do interfejsu API 26.

• Zaktualizowano targetSdkVersion do interfejsu API w wersji 36.

• Zaktualizowaliśmy obsługiwane wersje pakietu Navigation SDK, w tym wersję 7.0.0 i nowsze.

v6.99.0 (5 grudnia 2025 r.)

• Ulepszenia wewnętrzne

Ogłoszenie: wstrzymanie obsługi interfejsów API na poziomach 23, 24 i 25

Zgodnie z zasadami obsługi wersji mobilnego systemu operacyjnego wstrzymujemy obsługę Androida 6 i 7 (poziom interfejsu API 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ć Androida w wersji 8 (poziom interfejsu API 26) lub nowszej. Wcześniejsze wersje pakietu SDK będą nadal obsługiwać Androida 6 i 7.

Jeśli zależności nie określają numeru wersji, środowisko 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

• Naprawiliśmy błąd powodujący awarię NullPointerException podczas wywoływania DriverApi.createInstance(), gdy nie podano DriverStatusListener.

Zmiany zależności i konfiguracji

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

• Zaktualizowaliśmy 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!" (To błąd!) przy pierwszym uruchomieniu aplikacji po instalacji.

v6.0.0 (25 listopada 2024 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!" (To jest błąd!).
• 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. Po zintegrowaniu wersji będzie ona wdrażana stopniowo (od 0%).`

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 SDK do nawigacji do wersji 5.x.
• Od wersji 6.0.0 pakietu Driver SDK na Androida aplikacje muszą zostać uaktualnione do wersji Kotlin 2.0.
• targetSdk to teraz interfejs API na poziomie 34. Jest to wymagane w przypadku wszystkich aplikacji wdrażanych w Sklepie Google Play od sierpnia 2024 r. Zobacz Wymagania dotyczące docelowego poziomu interfejsu API w Google Play.

Wersja 5.99.0 (20 września 2024 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!" (To jest błąd!). Po zintegrowaniu wersji będzie ona wdrażana stopniowo (zaczynając 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. Po zintegrowaniu wersji będzie ona wdrażana stopniowo (od 0%).`

Zmiany zależności i konfiguracji

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

Wersja 5.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.
• thought 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 31 lub nowszego.
• Aplikacje korzystające z pakietu Driver SDK muszą teraz obsługiwać bibliotekę Java 8. Instrukcje aktualizacji znajdziesz na stronie https://developer.android.com/studio/write/java8-support.
• Aplikacje, które używają Proguard lub Dexguard, muszą przejść na R8. Więcej informacji znajdziesz na stronie https://developer.android.com/build/shrink-code.
• Aplikacje, które używają pakietu Driver SDK, muszą mieć włączone odlukrzanie. thought 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.
• Wprowadziliśmy nowy interfejs DriverStatusListener, który zgłasza przyczynę w aktualizacjach stanu wyjątków.
• Rozwiązaliśmy problem z kierowcami, którzy pozostawali w miejscu (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 (z wyłączeniem wersji 5.0.0).
• Zapobiegaj samoczynnemu zmniejszaniu się szacowanego czasu dotarcia na miejsce, gdy pojazd stoi. Ta zmiana będzie wprowadzana stopniowo w ramach eksperymentu, więc nie wszyscy reklamodawcy zobaczą ją jednocześnie.

v4.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ócenie czasu przywracania połączenia sieciowego, gdy pakiet SDK napotka tymczasowy problem z połączeniem. To jest poprawka eksperymentalna.

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

• Naprawiono sytuację wyścigu 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 ruchu.

Dodatkowe zmiany

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

Wersja 4.4.0 (21 września 2022 r.)

Poprawki błędów

• Naprawiliśmy 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 pomocy dotyczącej 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 interfejsu 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ć co najmniej Androida 5 (poziom interfejsu API 21) do 30 czerwca 2023 r.
• Po 30 czerwca 2023 r. będziemy obsługiwać tylko interfejsy API Androida na poziomie 23 lub wyższym. 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 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 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 właściwość nadal istnieje, ale została 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, zalecamy śledzenie go w kodzie aplikacji.

• Dodano nowe zajęcia: 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 metodę setAbnormalTerminationReportingEnabled() i przekazując jej wartość false przed zainicjowaniem pakietu SDK.

• Dodano funkcję setAbnormalTerminationReportingEnabled do DriverApi.

Asynchroniczne getRemainingVehicleStops

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

Uwierzytelnianie

Usunęliśmy niepotrzebne właściwości z interfejsu AuthTokenContext. Wycofano interfejs ServiceType. Teraz musisz tylko uzyskać uprawnienia do uwzględnionego identyfikatora pojazdu i identyfikatora zadania, zamiast polegać na ServiceType.

• Usunięto element ServiceType z AuthTokenContext.

• Usunięto element getServiceType() z AuthTokenContext.

• Usunięto element setServiceType z AuthTokenContext.Builder.

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

Wersja 3.0.4 (28 lipca 2021 r.)

Funkcje

W tej wersji pakiet SDK dla kierowców jest oficjalnie oddzielony od pakietu SDK do nawigacji. Szczegółowe informacje znajdziesz w przewodniku po migracji.

Aktualizacje interfejsów API

Dodano te metody:

`RidesharingDriverApi.getDriverSdkVersion()`

Poprawki błędów i ulepszenia stabilności

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 / dla kierowców na Androida stanie się pakietem SDK do nawigacji na Androida w wersji 3.x i pakietem SDK dla kierowców na Androida w wersji 3.x (rozdzielone pliki binarne).

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

• Pakiet Navigation SDK na Androida, który zapewnia kierowcom funkcje nawigacji i wyznaczania trasy.
• Pakiet Driver SDK na Androida, który umożliwia korzystanie z usług internetowych Fleet Engine z zachowaniem stanu, aby śledzić postępy i przydzielać przejazdy lub zadania.

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

Jakie zmiany wprowadzamy?

Najważniejsze zmiany w wersji 3:

• 2 pliki binarne zamiast jednego.
• Bardziej przejrzyste definicje pakietów dla klas Driver SDK na Androida.
• Pakiet SDK do nawigacji na Androida zawiera pakiet SDK Map na Androida (od wersji 2 pakietu SDK do nawigacji na Androida).
  • Dzięki temu funkcje map i nawigacji mogą współistnieć na tej samej mapie (np. rysowanie linii łamanych w NavigationView) i zmniejsza się wykorzystanie pamięci, ponieważ używana jest jedna mapa zamiast dwóch.
  • 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 sekcji Co i kiedy mogę zrobić?.
• 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 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 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 konsolidacje zduplikowanych klas między pakietem Navigation SDK na Androida a 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

Wersja 1 pakietu SDK do nawigacji i pakietu SDK dla kierowców została wydana w 2018 r. Wkrótce wydamy wersję 3, dlatego nadszedł czas na wycofanie wersji 1, aby uniknąć problemów z obsługą wielu wersji głównych.

Czas zaoszczędzony dzięki temu, że nie będziemy musieli obsługiwać 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 pakiety SDK nawigacji i kierowcy w wersji 1.x zostały wycofane i po 21 czerwca 2022 r. nie będą już obsługiwane.

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 SDK sterowników subskrybuje teraz pakiet SDK do nawigacji, aby otrzymywać aktualizacje o ruchu, które są wysyłane do interfejsu Fleet Engine API.

Poprawki błędów i ulepszenia stabilności

• Naprawiliśmy błąd powodujący awarię środowiska wykonawczego gRPC.

v1.15.2

Funkcje

Dodaliśmy możliwość zatrzymywania stałych powiadomień. Jeśli raportowanie lokalizacji zostanie zatrzymane w instancji Fleet Engine, wskazówki zostaną zatrzymane w Navigator, wszystkie detektory nawigacji zostaną wyrejestrowane, a NavigationFragment lub NavigationView zostanie wstrzymane.

Poprawki błędów i ulepszenia stabilności

• Naprawiliśmy błąd, który powodował zgłaszanie wyjątku po wyczyszczeniu 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 „zawieszonych” lokalizacji). Ta poprawka umożliwia dalsze korzystanie z ulepszonego raportowania lokalizacji. Problem z błędami ANR nie był związany z tymi ulepszeniami.

Poprawki błędów i ulepszenia stabilności

• Naprawiliśmy błąd, który czasami powodował wyświetlanie w aplikacji użytkownika linii prostej na początku trasy.
• Naprawiliśmy błąd, który mógł powodować błąd ANR, gdy pakiet SDK zgłaszał lokalizacje. Było to spowodowane ulepszeniami onArrival(), które były podatne na rywalizację o blokadę. W niektórych okolicznościach udało nam się 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 błędu ANR po zastosowaniu poprawki.

v1.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 uzyskiwania lokalizacji przyciągniętych do drogi niezależnie od stanu nawigacji.
• Dodaliśmy dodatkowe informacje o lokalizacjach przed przyciągnięciem do drogi, takie jak dokładność.

Poprawki błędów i ulepszenia stabilności

• Zwiększono minSdkVersion dla navsdk do 19.
• Naprawiliśmy błąd, który powodował, że nazwy punktów na trasie z szerokością i długością geograficzną nie były uwzględniane, gdy odwrotne geokodowanie po stronie serwera nie powiodło się.

Wersja 1.14.2 (2 lutego 2019 r.)

Funkcje

• Uniemożliwia pakietowi DriverSDK wysyłanie do Fleet Engine lokalizacji 0,0 (lepsze udostępnianie przejazdu i dane wejściowe dotyczące lokalizacji przydziału).
• Dodatkowe logowanie w celu rozwiązywania problemów z zawieszaniem się lokalizacji i ograniczania przypadków korzystania z rozwiązań zastępczych podczas udostępniania przejazdu.
• Ignoruj powtarzające się wywołania metody setLocationReportingInterval(), chyba że zmieni się interwał.
• Zaktualizowano dokumentację Javadoc metody setReportingInterval(), aby zniechęcić do wielokrotnego wywoływania tej metody z dużą częstotliwością w stosunku do używanych interwałów.
• Poprawiliśmy niezawodność lokalizacji w interfejsie API 29.

v1.13.0

Poprawki błędów i ulepszenia stabilności

• 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.)

Poprawki błędów i ulepszenia stabilności

• 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) pasuje do schematu kolorów ustawionego dla powiadomień nawigacyjnych. Więcej informacji znajdziesz w artykule o udostępnianiu trwałych powiadomień.
• Rozwiązaliśmy problem, który powodował, że opóźnione zdarzenie informacja o zmianie lokalizacji mogło powodować fałszywą informacja o zmianie lokalizacji, co skutkowało artefaktami, takimi jak linia prosta na początku trasy.

v1.11.6 (4 października 2019 r.)

Aktualizacje interfejsów API

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

Poprawki błędów i ulepszenia stabilności

• setVehicleState() teraz natychmiast zwraca wynik. Aktualizowanie FleetEngine odbywa się teraz w wątku w tle. Rozwiązaliśmy 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. Zapewnia, że pakiet SDK dla kierowców nie dodaje do trasy żadnych jednorazowych punktów pośrednich.