Informacje o wersji pakietu SDK sterownika na Androida

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

Ogłoszenie: zawieszenie obsługi poziomu interfejsu API 23, 24 i 25

Zgodnie z polityką dotyczącą obsługi wersji systemu operacyjnego mobilnego w przyszłych głównych wersjach pakietu Driver SDK na Androida zaprzestajemy obsługiwać Androida 6 i 7 (poziom interfejsu API 23, 24 i 25).

Wersje pakietu Driver SDK na Androida, które zostaną wydane począwszy od czwartego kwartału 2025 r., będą obsługiwać co najmniej Androida 8 (poziom API 26). Wcześniejsze 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 wersje aplikacji nie będą obsługiwać Androida 6 i 7.

W zależnościach kompilacji aplikacji określ wersję pakietu Driver SDK na Androida, aby kontrolować, kiedy zwiększyć minimalną obsługiwaną wersję systemu operacyjnego w przypadku nowych wersji aplikacji.

v6.0.0 (25 listopada 2024 r.)

Poprawki błędów

• Rozwiązaliśmy problem, w którym kierowcy otrzymywali błędy gRPC z kodem „INTERNAL” oraz komunikat „Panic! To jest błąd!”
• Wewnętrzna poprawka ma na celu zmniejszenie liczby błędów połączenia podczas aktualizowania lokalizacji, zwłaszcza gdy urządzenie przełącza się między sieciami. Będzie ona wprowadzana stopniowo (zaczynając od 0%), gdy tylko wdrożymy nową wersję.

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 SDK do nawigacji do wersji 5.x.
• Począwszy od wersji 6.0.0 pakietu Driver SDK na Androida aplikacje muszą zostać zaktualizowane do wersji Kotlin 2.0.
• Wartość targetSdk to teraz poziom API 34. Jest to wymóg dla wszystkich aplikacji, które od sierpnia 2024 r. będą publikowane w Sklepie Google Play. Zapoznaj się z wymaganiami Google Play dotyczącymi docelowego poziomu interfejsu API.

v5.99.0 (20 września 2024 r.)

Poprawki błędów

• Rozwiązaliśmy problem, w którym kierowcy otrzymywali błędy gRPC z kodem „INTERNAL” oraz komunikat „Panic! To jest błąd!” Funkcja ta będzie wdrażana stopniowo (zaczynając od 0%), gdy tylko zostanie zintegrowana.
• Wewnętrzna poprawka ma na celu zmniejszenie liczby błędów połączenia podczas aktualizowania lokalizacji, zwłaszcza gdy urządzenie przełącza się między sieciami. Będzie ona wprowadzana stopniowo (zaczynając od 0%), gdy tylko wdrożymy tę wersję.

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 SDK do nawigacji do wersji 5.x.
• Uaktualniono minSdkVersion do poziomu API 23.
• Uaktualniono Kotlin do wersji 1.9.0.
• Dodano zależność od pokoju. * Aplikacje korzystające z Driver SDK muszą mieć teraztargetSdkVersion na poziomie API 31 lub wyższym.
• Aplikacje korzystające z 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 korzystające z ProGuard lub Dexguard muszą zostać przeniesione na R8. Więcej informacji znajdziesz na stronie https://developer.android.com/build/shrink-code.
• Aplikacje korzystające z Driver SDK muszą mieć włączone desugaring. Instrukcje znajdziesz na stronie https://developer.android.com/studio/write/java8-support#library-desugaring.

Poprawki błędów

• Rozwiązano problem z synchronizacją disableLocationTracking.
• Wprowadziliśmy nowy interfejs DriverStatusListener, który przekazuje przyczynę aktualizacji stanu wyjątku.
• Rozwiązaliśmy problem z nieruchomymi kierowcami (dostępny 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 (ale nie włącznie).
• Zapobieganie automatycznemu zmniejszaniu szacowanego czasu przybycia, gdy pojazd stoi. Ta zmiana jest wprowadzana stopniowo jako eksperyment, więc nie wszystkie aplikacje zobaczą ją jednocześnie.

v4.5.0 (12 maja 2023 r.)

• Zaktualizuj zależność od pakietu SDK do nawigacji do wersji 4.5. Zwróć uwagę, że identyfikatory grup i elementów pakietu SDK do nawigacji zostały zmienione.

v4.4.3 (20 marca 2023 r.)

Zmiana zależności

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

v4.4.2 (15 lutego 2023 r.)

Poprawki błędów

• Skrócenie czasu przywracania połączenia sieciowego, gdy SDK napotka tymczasowy problem z połączeniem. Jest to rozwiązanie eksperymentalne.

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

• Naprawiono sytuację wyścigu w interfejsie API ALPHA „Route Overview”.

v4.4.1 (18 listopada 2022 r.)

Poprawki błędów

• Naprawiono błąd w logice przesyłania danych o ruchu.

Dodatkowe zmiany

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

v4.4.0 (21 września 2022 r.)

Poprawki błędów

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

Zmiana zależności

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

v4.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 na poziomie 21, jak i 22 interfejsu API.

Co to oznacza:

• Pakiet SDK nawigacji i pakiet SDK kierowcy działające w Twoich 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 poziomy interfejsu API 23 i nowsze. Inaczej mówiąc, 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 żadnej wersji pakietu SDK (w tym 4.x) nie zostaną naprawione i nie możemy zagwarantować, że pakiety SDK będą działać prawidłowo.

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

v4.2.0 (8 czerwca 2022 r.)

Zmiana zależności

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

4.1.0 (28 kwietnia 2022 r.)

Aktualizacje interfejsu API

• Nazwa właściwości parentId obiektu Task została zmieniona na trackingId. Stara usługa nadal istnieje, ale została wycofana.

v4.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 wprowadzono te zmiany:

Zmiana interfejsu VehicleStops API

Obiekty VehicleStop odwołują się teraz do listy obiektów TaskInfo, a nie do listy obiektów Task. Jeśli potrzebujesz stanu zadania, śledź go w kodzie aplikacji.

• Dodano nową klasę: TaskInfo

• Funkcję getTasks w arkuszu VehicleStop zastąpiono funkcją getTaskInfoList.

• Funkcję setTasks w arkuszu VehicleStop.Builder zastąpiono funkcją setTaskInfoList.

Monitorowanie awarii

Dodaliśmy funkcję monitorowania i raportowania 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, zanim zainicjujesz pakiet SDK.

• Dodano funkcję setAbnormalTerminationReportingEnabled do DriverApi.

Async getRemainingVehicleStops

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

Uwierzytelnianie

Usunęliśmy z interfejsu AuthTokenContext niepotrzebne usługi. Środowisko wykonawcze ServiceType zostało wycofane. Teraz wystarczy, że otrzymasz roszczenia dotyczące identyfikatora pojazdu i identyfikatora zadania, a nie ServiceType.

• Usunięto ServiceType z AuthTokenContext.

• Usunięto getServiceType() z AuthTokenContext.

• Usunięto setServiceType z AuthTokenContext.Builder.

18 października 2021 r. – zablokowanie obsługi poziomu interfejsu API 23, 24 i 25

.

v3.0.4 (28 lipca 2021 r.)

Funkcje

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

Aktualizacje interfejsu API

Dodano te metody:

`RidesharingDriverApi.getDriverSdkVersion()`

Poprawki stabilności i błędów

zgłaszać 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, które nastąpiło w dacie podanej powyżej. To powiadomienie zostało też wysłane jako obowiązkowe powiadomienie o usłudze do dotkniętych klientów.

Pakiet SDK do nawigacji/sterowania na Androida zostanie podzielony na pakiet SDK do nawigacji na Androida w wersji 3.x i pakiet SDK do sterowania na Androida w wersji 3.x (oddzielne pliki binarne)

Aby uprościć integrację z usługami klienta i przyspieszyć dostarczanie przydatnych funkcji, dzielimy pakiet SDK do nawigacji na Androida i pakiet SDK do sterowania nawigacją na Androida na 2 różne pliki binarne:

• Pakiet SDK do nawigacji na Androida, który zapewnia kierowcom funkcje nawigacji/kierowania.
• Pakiet SDK dla kierowców na Androida, który umożliwia korzystanie z usług sieciowych Fleet Engine z stanami w celu przypisywania i śledzenia postępów w wykonywaniu podróży lub zadań.

Pamiętaj, że pakiet Driver SDK na Androida wymaga pakietu SDK do nawigacji na Androida, aby można było korzystać z podstawowych funkcji wyznaczania tras.

Jakie zmiany?

Najważniejsze zmiany w wersji 3 to:

• 2 pliki binarne zamiast 1.
• bardziej przejrzyste definicje pakietów w przypadku klas Driver SDK na Androida;
• Pakiet SDK do nawigacji na Androida zawiera pakiet SDK Map na Androida jako część pakietu (stan na wersję 2 pakietu SDK do nawigacji na Androida).
  • Umożliwia to współistnienie map i funkcji nawigacji na tej samej mapie (np. rysowanie wielokątów na widoku nawigacji) oraz zmniejsza wykorzystanie pamięci, ponieważ zamiast 2 map używa się tylko 1 mapy.
  • Pakiet SDK do nawigacji na Androida w wersji 3.0 nie ma pełnej zgodności z pakietem 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 ewentualnych problemów.

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

• Te metody pakietu SDK Nawigacja/Kierowca 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 porządku i dla jasności: podczas przejścia z wersji 1 na 2 usunięto kilka metod. Większość z nich dotyczyła konsolidacji zduplikowanych klas między pakietami SDK do nawigacji i Maps 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 nawigacji/kierowca w wersji 1 został wydany w 2018 roku. Wkrótce udostępnimy wersję 3, więc nadszedł czas na wycofanie wersji 1, aby uniknąć nieopłacalnego wspierania wielu wersji głównych.

Czas zaoszczędzony dzięki temu, że nie musimy obsługiwać tej dodatkowej wersji, pozwoli nam lepiej obsługiwać najnowszą główną wersję i tworzyć więcej funkcji ważnych dla naszych klientów.

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

Poświęć chwilę na zapoznanie się z tym, jak działa wycofanie wersji pakietu SDK.

Zakończenie obsługi pakietów SDK do nawigacji i sterowania na Androidzie w wersjach 21 i 22

.

1.15.3 (9 października 2020 r.)

Aktualizacje interfejsu API

• Pakiet SDK Kierowcy subskrybuje teraz pakiet SDK Nawigacji w celu otrzymywania informacji o ruchu drogowym, które są wysyłane do interfejsu Fleet Engine API.

Poprawki stabilności i błędów

• Naprawiono błąd awarii gRPC w czasie działania.

v1.15.2

Funkcje

Dodaliśmy możliwość zatrzymania powiadomienia. Jeśli raportowanie lokalizacji zostało zatrzymane w instancji Fleet Engine, wskazówki są wstrzymywane w komponencie Navigator, wszystkie komponenty nasłuchujące nawigacji są niezarejestrowane, a komponent NavigationFragment lub NavigationView jest wstrzymany.

Poprawki stabilności i błędów

• Naprawiliśmy błąd, który powodował wyjątek, jeśli instancja Fleet Engine została wyczyszczona.

v1.15.1 (12 maja 2020 r.)

Funkcje

Wstępna analiza danych z wersji 1.15.0 wykazała znaczne ulepszenia w stabilnym raportowaniu lokalizacji (zmniejszenie liczby „utkwiętych” lokalizacji). Ta poprawka umożliwia dalsze ulepszone raportowanie lokalizacji. Problem z ANR nie był związany z tymi ulepszeniami.

Poprawki stabilności i 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ć wyświetlanie komunikatu ANR podczas zgłaszania lokalizacji przez pakiet SDK. Wynikało to z ulepszeń onArrival(), które były podatne na konflikty blokad. W pewnych okolicznościach udało nam się odtworzyć problemy z ANR i sprawdzić, czy wprowadzone poprawki je rozwiązały. Zmodyfikowana testowa aplikacja do generowania powiadomień ANR działała przez 8 godzin bez generowania powiadomień ANR po usunięciu problemu.

1.15.0 (23 marca 2019 r.)

Funkcje

• Wprowadziliśmy stan wskazówek nawigacji na potrzeby zdarzeń rozpoczęcia, zejścia z trasy i przyjazdu, aby poprawić śledzenie lokalizacji pojazdu.
• Dodaliśmy możliwość uzyskiwania lokalizacji na podstawie drogi niezależnie od stanu nawigacji.
• Dodaliśmy dodatkowe informacje o lokalizacjach z przedsięwzięciach pomiarowych, np. dokładność.

Stabilność i poprawki błędów

• Zwiększono wartość parametru minSdkVersion pakietu nawigacyjnego do 19.
• Naprawiliśmy błąd, który powodował, że nazwy punktów kontrolnych lat/lng nie były uwzględniane, gdy geokodowanie odwrotne po stronie serwera kończyło się niepowodzeniem.

Wersja 1.14.2 (2 lutego 2019 r.)

Funkcje

• Zapobiega wysyłaniu przez DriverSDK do Fleet Engine lokalizacji o wartości 0,0 (lepsze dane wejściowe dotyczące lokalizacji w przypadku udostępniania trasy i przydziału).
• Dodatkowe rejestrowanie danych na potrzeby rozwiązywania problemów z zawieszaniem się lokalizacji i ograniczania liczby zastępczych rozwiązań 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 wielokrotnego wywoływania tej metody z wysoką częstotliwością w stosunku do używanych interwałów.
• Zwiększona niezawodność lokalizacji w wersji API 29.

v1.13.0

Poprawki stabilności i błędów

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

v1.11.7 (18 października 2019 r.)

Poprawki stabilności i błędów

• Aktualizacje lokalizacji są teraz wysyłane po wywołaniu zdarzenia onArrival() dla danego miejsca docelowego.
• Domyślne powiadomienie (ciągły ciąg znaków w trybie nawigacji bezpłatnej) jest zgodne ze schematem kolorów ustawionym dla powiadomień nawigacyjnych. Więcej informacji znajdziesz w artykule Udostępnianie stałych powiadomień.
• Rozwiązaliśmy problem polegający na tym, że opóźnione zdarzenie aktualizacji lokalizacji mogło powodować fałszywą aktualizację lokalizacji, powodując artefakty takie jak prosta linia na początku trasy.

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

Aktualizacje interfejsu API

• Wprowadziliśmy serię zmian, które zapewniają, że po awarii sieci pakiet Driver SDK szybko wznawia aktualizacje lokalizacji. Po przywróceniu połączenia z siecią aktualizacje lokalizacji będą się odbywać zgodnie z harmonogramem.

Poprawki stabilności i błędów

• setVehicleState()zwraca teraz natychmiast. Aktualizacja FleetEngine odbywa się teraz w wątku w tle. Rozwiązuje problem Aplikacja nie odpowiada (ANR).
• Rozwiązaliśmy problem, który powodował, że trasy udostępniania ścieżki były wyświetlane jako prosta linia w starszych wersjach Consumer SDK. Upewnia się, że pakiet SDK Kierowcy nie dodaje do trasy żadnych jednorazowych punktów pośrednich.