Ta sekcja zawiera informacje o wersji pakietu Driver SDK na Androida.
Wersja 5.0.0 (12 września 2023 r.)
Zmiany w zależności i konfiguracji
- Zaktualizowano pakiet SDK nawigacji do wersji 5.x.
- Uaktualniono
minSdkVersion
do interfejsu API 23. - Uaktualniono Kotlin do wersji 1.9.0.
- Dodano zależność do Pokoju.
- Aplikacje korzystające z pakietu SDK Driver muszą teraz mieć interfejs
targetSdkVersion
API w wersji 31 lub nowszej. - Aplikacje korzystające z pakietu Driver SDK muszą teraz obsługiwać bibliotekę Java 8. Instrukcje dotyczące aktualizacji znajdziesz na stronie https://developer.android.com/studio/write/java8-support.
- Aplikacje korzystające z 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ą umożliwiać obsługę odlustrowania. Instrukcje znajdziesz na stronie https://developer.android.com/studio/write/java8-support#library-desugaring.
Poprawki błędów
- Rozwiązaliśmy problem z synchronizacją wyłączonych lokalizacji.
- Wprowadzono nowy interfejs DriverStatusListener, który zgłasza przyczynę w aktualizacji stanu wyjątku.
- Rozwiązaliśmy problem polegający na tym, że sterowniki pozostały nieruchome (dostępne od wersji 4.99.0).
Wersja 4.99.0 (9 sierpnia 2023 r.)
- Obsługuj zakres wersji zależności NavSDK. ** Obsługuje wersje 4.5.0 do wersji 5.0.0 (ale bez niej).
- Zapobiegaj samoczynnie zmniejszaniu się szacowanego czasu dotarcia na miejsce, gdy pojazd się znajduje. Tę zmianę wprowadzamy stopniowo w ramach eksperymentu, więc nie we wszystkich aplikacjach pojawi się ona jednocześnie.
Wersja 4.5.0 (12 maja 2023 r.)
- Zaktualizuj zależność pakietu Navigation SDK do wersji 4.5. Pamiętaj, że identyfikatory grup i artefaktów pakietu Navigation SDK uległy zmianie.
v4.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 sieci, gdy pakiet SDK napotka tymczasowy problem z połączeniem. Obecnie jest to funkcja eksperymentalna.
Odrzuć żądania
UpdateVehicle
, które zawierają tylko wartość „Nieprzetworzona” lokalizacji.Popraw stan wyścigu na „Przeglądzie trasy” ALFA.
Wersja 4.4.1 (18 listopada 2022 r.)
Poprawki błędów
- Naprawiliśmy błąd w procesie przesyłania danych o ruchu.
Dodatkowe zmiany
- Usprawnienia wewnętrznych nagłówków żądań i raportowania kodów stanu.
Wersja 4.4.0 (21 września 2022 r.)
Poprawki błędów
- Naprawiliśmy błąd, który uniemożliwiał „Jazdę z Mapami Google”. powiadomienia o usunięciu, jeśli instancja interfejsu API nie została wyczyszczona.
Zmiana zależności
- Uaktualnij zależność pakietu Navigation SDK do wersji 4.2.2.
Wersja 4.3.0 (24 sierpnia 2022 r.)
Usprawnienia wewnętrzne.
Ogłoszenie: zawieszanie obsługi Androida 5 (21 lipca 2022 r.)
W najnowszej wersji pakietu SDK (v4.2.0) o dodatkowy rok wsparcia dla aplikacji działających na Androidzie 5, Poziomy API 21 i 22.
Co to oznacza:
- Pakiet Navigation SDK i Driver SDK działające w aplikacjach na Androida będą obsługiwać Androida 5 (poziom interfejsu API 21) do 30 czerwca 2023 r.
- Po 30 czerwca 2023 r. będziemy obsługiwać tylko interfejs API Androida na poziomie 23 i wyższych. Innymi słowy, przestaniemy obsługiwać interfejs API na poziomach 21 i 22 wszystkich wersji pakietu SDK po tej dacie. Oznacza to, że błędy związane z Androidem 21 lub 22 w dowolnej wersji pakietu SDK (w tym 4.x) nie zostaną naprawione. zagwarantuje, że pakiety SDK będą działać prawidłowo.
Ta informacja zastępuje powiadomienie o zawieszeniu systemu w Androidzie 21 i 22 od czerwca 21 października 2021 roku, a w przypadku Androida 23, 24 i 25 od 18 października 2021 r. ta funkcja się zatrzyma.
Wersja 4.2.0 (8 czerwca 2022 r.)
Zmiana zależności
- Uaktualnij zależność pakietu Nav SDK do wersji 4.1.3.
- Zmienia minimalny obsługiwany poziom interfejsu API Androida na 21.
Wersja 4.1.0 (28 kwietnia 2022 r.)
Aktualizacje interfejsu API
Zmieniono nazwę właściwości
parentId
obiektuTask
natrackingId
. Stary Usługa wciąż istnieje, ale została wycofana.Zmieniono niektóre typy zwrotów z
Future
na bardziej szczegółoweListenableFuture
i odList
do bardziej szczegółowego:ImmutableList
.
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 pakiet Driver SDK na Androida został zaktualizowany o następujące funkcje: zmian.
Zmiana interfejsu API VehicleStops
VehicleStop
obiektów odwołuje się teraz do listy
TaskInfo
obiektów zamiast listy
Task
obiektów. Jeśli potrzebujesz stanu zadania,
zalecamy śledzenie jej w kodzie aplikacji.
Dodano nowe zajęcia:
TaskInfo
Funkcja
getTasks
w tabeliVehicleStop
została zastąpionagetTaskInfoList
.Funkcja
setTasks
w tabeliVehicleStop.Builder
została zastąpionasetTaskInfoList
.
Monitorowanie awarii
Dodaliśmy monitorowanie i raportowanie awarii, aby pomóc zwiększyć stabilność pakietu SDK.
Ta funkcja jest domyślnie włączona, ale można ją wyłączyć, gdy zadzwonisz
setAbnormalTerminationReportingEnabled()
i przekaż mu wartość false
przed zainicjowaniem pakietu SDK.
- Dodano
setAbnormalTerminationReportingEnabled
doDriverApi
.
Async getRemainingVehicleStops
- Zmieniono
DeliveryVehicleReporter
getRemainingVehicleStops
funkcja zwracająca zdarzenie w przyszłości. zamiast Lista<VehicleStop>.
Uwierzytelnianie
Z interfejsu AuthTokenContext
usunięto zbędne właściwości.
Usługa ServiceType
została wycofana. Teraz musisz otrzymywać tylko roszczenia dotyczące
zawiera identyfikator pojazdu i identyfikator zadania, zamiast korzystać z metody ServiceType
.
Użytkownik
ServiceType
został usunięty zAuthTokenContext
Użytkownik
getServiceType()
został usunięty zAuthTokenContext
Użytkownik
setServiceType
został usunięty zAuthTokenContext.Builder
18 października 2021 r. – blokowanie poziomu 23, 24 i 25 interfejsu API
Przeczytaj ogłoszenie z 18 października
W odpowiedzi na zmiany w zależnościach wewnętrznych, Android API na poziomie 23 24 i 25 (Android 6, 7.0 i 7.1) nie będą obsługiwane w nowych wersjach pakietów SDK nawigacji i kierowców na Androida, począwszy od kwartału 2022 r.
Pakiety SDK do nawigacji i sterowników na Androida opublikowane od 3 lat w kwartale 2022 r. będą obsługiwać tylko urządzenia z Interfejs API Androida poziomu 26.
Wersje aplikacji z pakietami SDK nawigacji i sterownikami w wersji 4.x lub starszej Android będzie nadal działać na urządzeniach z interfejsem API Androida na poziomie 25. i niżej.
Wersja 3.0.4 (28 lipca 2021 r.)
Funkcje
W tej wersji pakiet Driver SDK został oficjalnie są oddzielone od pakietu Navigation SDK. Zobacz przewodnik po migracji .
Aktualizacje interfejsu API
Dodano te metody:
DeliveryDriverApi.getDriverSdkVersion()
Stabilność i poprawki błędów
Zgłoś PERMISSION_DENIED
błędu, zamiast klasyfikować je jako
błędów połączenia.
Ogłoszenie o wycofaniu (21 czerwca 2021 r.)
To ogłoszenie dotyczy wycofania pakietu Driver SDK na Androida. pakietu Navigation SDK na Androida. To powiadomienie zostało również wysłane jako obowiązkowe powiadomienie klientom, których to dotyczy.
Nav/Driver SDK na Androida zostanie przekształcony w pakiet Navigation SDK na Androida w wersji 3.x oraz pakiet Driver SDK na Androida w wersji 3.x na Androida (podzielone pliki binarne)
Aby uprościć integrację klientów i przyspieszyć dostarczanie przydatnych usług dzielimy Navigation SDK na Androida i Pakiet Driver SDK dla Androida na 2 różne pliki binarne:
- Pakiet Navigation SDK na Androida, który zapewnia nawigację i trasy. dla kierowców.
- Pakiet Driver SDK na Androida, który umożliwia wykorzystanie floty Stanowe usługi internetowe silnika do obsługi podróży lub postępu zadań i ich przydzielania.
Pamiętaj, że pakiet Driver SDK dla Androida wymaga zależności Pakiet Navigation SDK na Androida do obsługi podstawowych funkcji routingu.
Jakie są te zmiany?
Najważniejsze zmiany w wersji 3:
- Dwa pliki binarne, a nie jeden.
- Bardziej przejrzyste definicje pakietów SDK Driver SDK dla klas Androida.
- Pakiet Navigation SDK na Androida zawiera pakiet Maps SDK na Androida.
jako część opakowania (w wersji Navigation SDK na Androida v2).
- Dzięki temu mapy i funkcje nawigacyjne mogą współistnieć na tej samej mapie (np. rysowanie linii łamanych w NavigationView) i zmniejsza wykorzystanie pamięci. bo używana jest jedna mapa, a nie dwie.
- Pakiet Navigation SDK na Androida 3.0 nie jest zgodny z wszystkimi funkcjami pakietu Navigation SDK na Androida, ale wersja 3.2 rozwiązuje większość problemów. Zobacz Co mogę zrobić i kiedy?, aby dowiedzieć się więcej.
- Logowanie, które ułatwi nam debugowanie napotkanych problemów.
W wersji 3 usunęliśmy również poniższe metody, ponieważ były oznaczone jako wycofane i w przypadku których alternatywne rozwiązanie już istnieje istnieje:
- Następujące metody pakietu Nav/Driver SDK zostały wycofane w wersji 1.16 i udostępnione
10 sierpnia 2020 r. i zostały usunięte w wersji 3.0:
Waypoint#fromLatLng(*)
Waypoint#fromPlaceId(*)
Navigator#startGuidance(resumeIntent)
NavigationApi#initForegroundServiceManager(*)
- Aby wzbogacić informacje, pamiętaj, że usunęliśmy kilka metod w przejściach z wersji 1–2. Większość z tych czynności obejmowała konsolidację duplikatów między pakietem SDK Navigation na Androida a pakietem Maps SDK na Androida. Zapoznaj się z przewodnik po migracji aby lepiej zrozumieć te zmiany.
Wycofanie pakietów Driver SDK na Androida i Navigation SDK na Androida w wersji 1.x
Pakiet Nav/Driver SDK w wersji 1 został wprowadzony w 2018 r., a wkrótce również czas na wycofanie wersji 1, by uniknąć obsługujące wiele głównych wersji.
Oszczędność czasu bez konieczności obsługi tej dodatkowej wersji pozwoli lepsze wsparcie najnowszej wersji głównej i tworzenie większej liczby funkcji, są ważne dla naszych klientów.
Z tego powodu pakiet Nav/Driver SDK w wersji 1.x został wycofany i nie będzie już obsługiwany. po 21 czerwca 2022 r.
Poświęć chwilę, aby je zobaczyć jak działają wycofywania w wersjach pakietu SDK.
Zakończenie obsługi pakietu Navigation and Driver SDK na Androida 21 i 22
Przeczytaj odwołane ogłoszenie
Nadchodząca wersja 4.0 pakietu Navigation SDK na Androida Pakiet SDK sterownika na Androida obsługuje minimalną [Android 6.0 (poziom interfejsu API 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. Aktualna minimalna obsługiwana wersja to Android 5.0 (poziom interfejsu API 21). Planujemy udostępnić wersję 4.0 w IV kwartale 2021 r. Oznacza to, że:
- Wersje aplikacji utworzone wcześniej niż 4.x będą nadal działać Urządzenia z Androidem 21 i 22. Twoje aplikacje sterowników ze zintegrowanym obecne pakiety SDK będą nadal działać na urządzeniach z Androidem 21 lub nowszym. Tak samo jak wcześniej.
- Wersje aplikacji utworzone za pomocą Driver SDK na Androida i Navigation SDK na Androida 4.x (kierowana na IV kwartału 2021 r. (może ulec zmianie) i później nie będzie można zainstalować na urządzenia z Androidem 21 i 22. Wersja 4.x będzie działać z Androidem 6.0 (poziom interfejsu API 23) lub dlatego wersje aplikacji oparte na nadchodzącej wersji 4.x mogą być otrzymywane przez kierowców urządzeń z Androidem 23 lub nowszym. Powtarzam: Oznacza to, że zarówno zmiany związane z pakietem SDK, jak i wszelkie zmiany w aplikacji nie będzie działać na kierowcach na urządzeniach z Androidem 21 i 22.
pakietu Navigation SDK na Androida 3 oraz Pakiet SDK sterownika na Androida w wersji 3, do której chcesz przejść zostały wyjaśnione w tabeli poniżej oraz wraz z informacjami o tym, kiedy będą dostępne.
Których funkcji platformy kierowców używasz? | Czy korzystasz z tych funkcji? | Pierwsze dostępne wersje, na które należy przejść, to... | Spodziewana dostępność (może ulec zmianie) |
Linki do migracji |
---|---|---|---|---|
Tylko nawigacja (metody NavSDK) |
Nie | NavSDK w wersji 3.0.1 | Teraz | Przewodnik |
Tak | NavSDK w wersji 3.5 (prognozowane) | wrzesień 2021 r. | ||
Nawigacja i śledzenie Fleet Engine (metody NavSDK i DriverSDK) | Nie | Nav SDK w wersji 3.0 i SDK sterownika 3.0 | Przewodnik po migracji sterownika w wersji 3.0 dostępny w wersji | |
Tak | NavSDK w wersji 3.x i DriverSDK w wersji 3.0 |
Aby nadal korzystać z usuniętych metod, możesz pozostać przy wersji 1.x, ale oczekiwania na pomoc i konserwację po 21 czerwca 2022 r. (patrz sekcja poniżej).
Zalecamy przejście na wersję 3.x. Oznacza to, że:
* Najnowsza wersja v1.x pojawi się w IV kwartale 2021 r. (więc wersja 1 to „funkcja zablokowana”.
* Poprawkę do ostatniej wersji można zainstalować przez 6 miesięcy później, do 21 czerwca 2022 r. Po tym czasie nie będziemy mogli odpowiadać na błędy ani prośby o dodanie funkcji. dla v1.x.
Poświęć chwilę na zapoznanie się z tą tabelą oraz [przewodnik po migracji](/maps/documentation/navigation-sdk-android/v2/migration) w aby ułatwić Ci wprowadzenie tych zmian.
Co mogę zrobić do kiedy?
Jeśli obecnie używasz... | Czy korzystasz z tych funkcji? | Aby uaktualnić teraz | Aby przejść na wyższą wersję we wrześniu 2021 r. | Linki do migracji |
---|---|---|---|---|
Wersja 1.x (nie z użyciem funkcji FleetEngine.java lub sterownika) |
Nie | NavSDK w wersji 3.0 | Przewodnik | |
Tak | Brak takiej opcji | NavSDK 3.x | ||
Wersja 1.x (z użyciem funkcji FleetEngine.java lub sterownika) |
Nie | Brak takiej opcji | NavSDK 3.x + DriverSDK 3.x |
Przewodnik powyżej oraz przewodnik po migracji sterownika w wersji 3.0 dostępny w momencie wprowadzenia zmian. |
Tak |
Zalecamy powiadamianie kierowców na urządzeniach z Androidem 21 i 22 musisz przejść na nowszą wersję Androida (co najmniej 6.0). zintegruj pakiet Driver SDK na Androida i pakiet Navigation SDK na Androida wersji 4.x lub nowszej do aplikacji sterownika.
Wersja 1.15.3 (9 października 2020 r.)
Aktualizacje interfejsu API
- Pakiet Driver SDK subskrybuje teraz pakiet Navigation SDK na potrzeby aktualizacji o natężeniu 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
Dodano możliwość zatrzymywania trwałego powiadomienia. Jeśli raportowanie lokalizacji
jest zatrzymany w instancji Fleet Engine, wskazówki są zatrzymywane w instancji Navigator
,
wszyscy detektory nawigacji są wyrejestrowane, a NavigationFragment
lub NavigationView
jest wstrzymany.
Stabilność i poprawki błędów
- Naprawiliśmy błąd, który powodował zgłaszanie wyjątku, jeśli instancja Fleet Engine została wyczyszczona.
Wersja 1.15.1 (12 maja 2020 r.)
Funkcje
Wstępna analiza danych 1.15.0 wykazała znaczną poprawę w stabilnym raportowaniu lokalizacji (zmniejszenie liczby „utkniętych” lokalizacji). Ta poprawka umożliwia kontynuację ulepszonego raportowania lokalizacji. Problem z błędem ANR nie miał związku do tych ulepszeń.
Stabilność i poprawki błędów
- Naprawiliśmy błąd, który czasem powodował rysowanie prostej linii na początku trasy, która ma być widoczna w aplikacji dla konsumenta.
- Naprawiliśmy błąd, który mógł powodować błąd ANR podczas zgłaszania lokalizacji
przez pakiet SDK. Było to spowodowane
onArrival()
ulepszeniami, które zostały podatne na rywalizację o blokadę. Udało nam się odtworzyć błędy ANR w pewnych okolicznościach i udało się nam sprawdzić, czy poprawki zostały rozwiązane i rozpoznają problem. Zmodyfikowana aplikacja testowa do generowania błędów ANR działała przez 8 godzin bez błędu ANR.
v1.15.0 (23 marca 2019 r.)
Funkcje
- Wprowadzono stan wskazówek nawigacji na początku, poza trasą i przyjechaniu na miejsce do lepszego śledzenia lokalizacji pojazdu.
- Dodano możliwość dalszego korzystania z przypiętych lokalizacji stanu nawigacji.
- Dodaliśmy dodatkowe informacje o lokalizacjach zarezerwowanych przed drogami, np. dokładność.
Stabilność i poprawki błędów
- Zwiększyliśmy wartość minSdkVersion dla pakietu navsdk do 19.
- Naprawiliśmy błąd, który powodował, że nazwy punktów Waypoint do określania szerokości i długości geograficznej nie były uwzględniane podczas odwrotne geokodowanie po stronie serwera nie działa.
Wersja 1.14.2 (2 lutego 2019 r.)
Funkcje
- Uniemożliwia pakietowi DriverSDK wysłanie 0,0 lokalizacji do Fleet Engine (lepsze udostępnianie trasy i dane wejściowe lokalizacji alokacji).
- Dodatkowe logowanie, które eliminuje problemy z zablokowaną lokalizacją i zmniejsza na potrzeby udostępniania ścieżek.
- Zignoruj powtarzające się wywołania
setLocationReportingInterval()
, chyba że interwał się zmieni. - Zaktualizowano dokumenty javadocs dla metody
setReportingInterval()
z celem zniechęcania do powtarzania tej metody w dużej mierze do poszczególnych interwałów. - Zwiększono niezawodność lokalizacji interfejsu API 29.
v1.13.0
Stabilność i poprawki błędów
- Dodaje zależność od okhttp, którą klienci muszą dodać do kompilacji Gradle.
1.11.7 (18 października 2019 r.)
Stabilność i poprawki błędów
- Aktualizacje lokalizacji będą kontynuowane po uruchomieniu aplikacji
onArrival()
przez danego miejsca docelowego. - Domyślne powiadomienie (ciąg stały w trybie swobodnej nawigacji) odpowiada parametrowi schemat kolorów dla powiadomień nawigacji. Więcej informacji: Udostępniane trwałe powiadomienia.
- Rozwiązaliśmy problem, który powodował, że zdarzenie opóźnionej aktualizacji lokalizacji mogło powodować fałszywą aktualizację lokalizacji, powodując artefakty, takie jak prosta linia na początku trasy.
1.11.6 (4 października 2019 r.)
Aktualizacje interfejsu API
- Wprowadziliśmy serię zmian, dzięki którym pakiet Driver SDK zostanie wznowiony. lokalizacja jest aktualizowana szybko po awarii sieci. Gdy połączenie sieciowe zostało przywrócone, aktualizacje lokalizacji rozpoczną się ponownie w następnej zaplanowanej lokalizacji .
Stabilność i poprawki błędów
setVehicleState()
Teraz powraca natychmiast. Aktualizacja FleetEngine odbywa się teraz w tle w wątku. Rozwiązano problem z aplikacją nie odpowiada (ANR).- Rozwiązaliśmy problem, który powodował wyświetlanie tras udostępniania podróży jako za pomocą starszych wersji pakietu Consumer SDK. Zapewnia, że nie jednorazowe punkty pośrednie są dodawane do trasy przez pakiet Driver SDK.