Versionshinweise zum Driver SDK for Android

Dieser Abschnitt enthält Versionshinweise für das Driver SDK for Android.

Ankündigung: Einstellung der Unterstützung für API-Level 23, 24 und 25

Gemäß der Richtlinie zur Unterstützung von mobilen Betriebssystemversionen stellen wir die Unterstützung für Android 6 und 7 (API-Level 23, 24 und 25) in den kommenden Hauptversionen des Driver SDK für Android ein.

Versionen des Driver SDK for Android, die ab dem vierten Quartal 2025 veröffentlicht werden, unterstützen mindestens Android 8 (API-Level 26). Ältere SDK-Versionen unterstützen weiterhin Android 6 und 7.

Wenn in Ihren Abhängigkeiten keine Versionsnummer angegeben ist, lädt Ihre IDE die neueste SDK-Version und neue Builds Ihrer App unterstützen Android 6 und 7 nicht.

Geben Sie in den Build-Abhängigkeiten Ihrer Anwendung eine Version des Driver SDK für Android an, um zu steuern, wann Sie die Mindestversion des unterstützten Betriebssystems für neue Versionen Ihrer App anheben.

v6.2.0 (18. Juni 2025)

Fehlerkorrekturen

• Der NullPointerException-Absturz beim Aufrufen von DriverApi.createInstance() wurde behoben, wenn kein DriverStatusListener angegeben wurde.

Änderungen an Abhängigkeiten und Konfigurationen

• Ab Version 6.2.0 des Driver SDK for Android müssen Apps auf Kotlin 2.1 aktualisiert werden.

• Die unterstützten Versionsbereiche des Navigation SDK wurden aktualisiert. Sie umfassen jetzt auch Version 6.1.0 und alle nachfolgenden Versionen.

v6.1.0 (10. März 2025)

Fehlerkorrekturen

• Verbesserungen bei der internen Protokollierung.

v5.99.1 (10. Januar 2025)

Fehlerkorrekturen

• Ein Problem wurde behoben, bei dem Fahrer gRPC-Fehler mit dem Code „INTERNAL“ und der Meldung „Panic! Beschreibung „Das ist ein Fehler!“ beim ersten Start der App nach der Installation.

v6.0.0 (25. November 2024)

Fehlerkorrekturen

• Ein Problem wurde behoben, bei dem Fahrer gRPC-Fehler mit dem Code „INTERNAL“ und der Meldung „Panic! „Das ist ein Fehler!“
• Interne Verbesserung zur Reduzierung von Verbindungsfehlern bei Standortaktualisierungen, insbesondere wenn das Gerät das Netzwerk wechselt. Die Funktion wird nach der Integration des Releases schrittweise eingeführt (beginnend bei 0%).`

API-Updates

• Die eingestellte Schnittstelle StatusListener wurde entfernt.

Änderungen an Abhängigkeiten und Konfigurationen

• Entfernen Sie die Abhängigkeit von glide:cronet-integration in der Datei POM.xml.
• Die unterstützten Versionsbereiche des Navigation SDK wurden auf v5.x aktualisiert.
• Ab Version 6.0.0 des Driver SDK for Android müssen Apps auf Kotlin 2.0 aktualisiert werden.
• Das targetSdk ist jetzt API-Level 34. Dies ist eine Anforderung für alle Apps, die ab August 2024 im Google Play Store bereitgestellt werden. Weitere Informationen finden Sie unter Anforderungen an das Ziel-API-Level von Google Play erfüllen.

v5.99.0 (20. September 2024)

Fehlerkorrekturen

• Ein Problem wurde behoben, bei dem Fahrer gRPC-Fehler mit dem Code „INTERNAL“ und der Meldung „Panic! „Das ist ein Fehler!“ Die Funktion wird nach der Integration des Releases schrittweise eingeführt (beginnend bei 0%).
• Interne Verbesserung zur Reduzierung von Verbindungsfehlern bei Standortaktualisierungen, insbesondere wenn das Gerät das Netzwerk wechselt. Die Funktion wird nach der Integration des Releases schrittweise eingeführt (beginnend bei 0%).`

Änderungen an Abhängigkeiten und Konfigurationen

• Entfernen Sie die Abhängigkeit von glide:cronet-integration in der Datei POM.xml.

v5.0.0 (12. September 2023)

Änderungen an Abhängigkeiten und Konfigurationen

• Das Navigation SDK wurde auf Version 5.x aktualisiert.
• minSdkVersion wurde auf API 23 aktualisiert.
• Die Kotlin-Version wurde auf 1.9.0 aktualisiert.
• Abhängigkeit von Room hinzugefügt. * Apps, die das Driver SDK verwenden, müssen jetzt targetSdkVersion von API 31 oder höher haben.
• Für Apps, die das Driver SDK verwenden, muss jetzt die Unterstützung für Java 8-Bibliotheken aktiviert werden. Eine Anleitung zum Aktualisieren finden Sie unter https://developer.android.com/studio/write/java8-support.
• Apps, die ProGuard oder DexGuard verwenden, müssen zu R8 migrieren. Weitere Informationen finden Sie unter https://developer.android.com/build/shrink-code.
• In Apps, in denen das Driver SDK verwendet wird, muss Desugaring aktiviert sein. Eine Anleitung finden Sie unter https://developer.android.com/studio/write/java8-support#library-desugaring.

Fehlerkorrekturen

• Das Problem mit der Synchronisierung von „disableLocationTracking“ wurde behoben.
• Es wurde eine neue DriverStatusListener-Schnittstelle eingeführt, die in Statusupdates für Ausnahmen eine Ursache meldet.
• Ein Problem wurde behoben, bei dem Fahrer nicht vom Fleck kamen (verfügbar ab Version 4.99.0).

v4.99.0 (9. August 2023)

• Unterstützung verschiedener Versionen für die NavSDK-Abhängigkeit ** Unterstützt Version 4.5.0 bis (aber nicht einschließlich) Version 5.0.0.
• Verhindern, dass die voraussichtliche Ankunftszeit automatisch abnimmt, wenn das Fahrzeug steht. Diese Änderung wird nach und nach als Test eingeführt. Daher ist sie nicht für alle Anwendungen gleichzeitig verfügbar.

v4.5.0 (12. Mai 2023)

• Aktualisieren Sie die Navigation SDK-Abhängigkeit auf Version 4.5. Die Gruppen- und Artefakt-IDs für das Navigation SDK haben sich geändert.

v4.4.3 (20. März 2023)

Änderung der Abhängigkeit

• Aktualisieren Sie die Navigation SDK-Abhängigkeit auf Version 4.4.1.

v4.4.2 (15. Februar 2023)

Fehlerkorrekturen

• Die Zeit, die das SDK benötigt, um sich von einem vorübergehenden Verbindungsproblem zu erholen, wurde verkürzt. Dies ist eine experimentelle Korrektur.

• UpdateVehicle-Anfragen verwerfen, die nur einen „Roh“-Standort enthalten.

• Es wurde eine Race-Bedingung in der ALPHA-API „Routenübersicht“ behoben.

v4.4.1 (18. November 2022)

Fehlerkorrekturen

• Ein Fehler in der Logik für das Hochladen von Traffic wurde behoben.

Weitere Änderungen

• Interne Verbesserungen bei Anfrageheadern und Statuscodeberichten.

v4.4.0 (21. September 2022)

Fehlerkorrekturen

• Ein Fehler wurde behoben, der verhinderte, dass die Benachrichtigung „Mit Google Maps fahren“ entfernt wurde, wenn die API-Instanz nicht gelöscht wurde.

Änderung der Abhängigkeit

• Aktualisieren Sie die Navigation SDK-Abhängigkeit auf Version 4.2.2.

v4.3.0 (24. August 2022)

Interne Verbesserungen.

Ankündigung: Einstellung der Unterstützung für Android 5 (21. Juli 2022)

Für unsere aktuelle SDK-Version (v4.2.0) bieten wir ein zusätzliches Jahr Support für Apps unter Android 5, sowohl für API-Level 21 als auch für API-Level 22.

Was das bedeutet:

• Das Navigation SDK und das Driver SDK, die in Ihren Android-Apps ausgeführt werden, unterstützen bis zum 30. Juni 2023 mindestens Android 5 (API-Level 21).
• Nach dem 30. Juni 2023 unterstützen wir nur noch Android-API-Levels 23 und höher. Das bedeutet, dass wir Android API-Level 21 und 22 ab diesem Datum in allen SDK-Versionen nicht mehr unterstützen. Das bedeutet, dass Fehler im Zusammenhang mit Android 21 oder 22 in einer beliebigen SDK-Version (einschließlich 4.x) nicht behoben werden und wir nicht garantieren können, dass sich die SDKs korrekt verhalten.

Diese Mitteilung ersetzt die Mitteilung vom 21. Juni 2021 zur Einstellung der Unterstützung für Android 21 und 22 sowie die Mitteilung vom 18. Oktober 2021 zur Einstellung der Unterstützung für Android 23, 24 und 25.

v4.2.0 (8. Juni 2022)

Änderung der Abhängigkeit

• Aktualisieren Sie die Nav SDK-Abhängigkeit auf Version 4.1.3.
• Das unterstützte Mindest-Android-API-Level wird auf 21 herabgestuft.

v4.1.0 (28. April 2022)

API-Updates

• Das Attribut parentId des Task-Objekts wurde in trackingId umbenannt. Die alte Property ist vorerst noch vorhanden, wird aber nicht mehr unterstützt.

v4.0.0 (29. November 2021)

Das für diese Version unterstützte Mindest-API-Level für Android ist 23.

API-Updates

Für diese Version wurde das Driver SDK for Android mit den folgenden Änderungen aktualisiert.

Änderung der VehicleStops API

VehicleStop-Objekte verweisen jetzt auf eine Liste von TaskInfo-Objekten anstelle einer Liste von Task-Objekten. Wenn Sie den Aufgabenstatus benötigen, sollten Sie ihn in Ihrem Anwendungscode erfassen.

• Neue Klasse hinzugefügt: TaskInfo

• Die Funktion getTasks von VehicleStop wurde durch die Funktion getTaskInfoList ersetzt.

• Die Funktion setTasks von VehicleStop.Builder wurde durch die Funktion setTaskInfoList ersetzt.

Absturzüberwachung

Es wurde eine Absturzüberwachung und ‑berichterstellung hinzugefügt, um die SDK-Stabilität zu verbessern. Diese Funktion ist standardmäßig aktiviert. Sie können sie jedoch deaktivieren, indem Sie setAbnormalTerminationReportingEnabled() aufrufen und den Wert false übergeben, bevor Sie das SDK initialisieren.

• Die Funktion setAbnormalTerminationReportingEnabled wurde zu DriverApi hinzugefügt.

Async getRemainingVehicleStops

• Die Funktion getRemainingVehicleStops von DeliveryVehicleReporter wurde so geändert, dass sie ein Future<List<VehicleStop>> anstelle einer List<VehicleStop> zurückgibt.

Authentifizierung

Unnötige Properties wurden aus der AuthTokenContext-Schnittstelle entfernt. ServiceType wurde eingestellt. Sie müssen jetzt nur noch Ansprüche für die enthaltene Fahrzeug-ID und Aufgaben-ID abrufen und nicht mehr auf ServiceType angewiesen sein.

• ServiceType wurde aus AuthTokenContext entfernt.

• getServiceType() wurde aus AuthTokenContext entfernt.

• setServiceType wurde aus AuthTokenContext.Builder entfernt.

18. Oktober 2021 – Eingefrorener Support für API-Level 23, 24 und 25

Version 3.0.4 (28. Juli 2021)

Funktionen

Mit dieser Version wird das Driver SDK offiziell vom Navigation SDK getrennt. Weitere Informationen finden Sie in der Migrationsanleitung.

API-Updates

Die folgenden Methoden wurden hinzugefügt:

`RidesharingDriverApi.getDriverSdkVersion()`

Stabilitätsverbesserungen und Fehlerkorrekturen

PERMISSION_DENIED-Fehler melden, anstatt sie als Verbindungsfehler zu klassifizieren.

Ankündigung der Einstellung (21. Juni 2021)

In dieser Mitteilung werden die Änderungen am Driver SDK for Android und am Navigation SDK for Android beschrieben, die ab dem oben genannten Datum in Kraft treten. Diese Mitteilung wurde auch als Servicemitteilung an betroffene Kunden gesendet.

Das Nav/Driver SDK for Android wird in Navigation SDK for Android v3.x und Driver SDK for Android v3.x für Android aufgeteilt (separate Binärdateien).

Um die Kundenintegration zu vereinfachen und die Bereitstellung nützlicher Funktionen zu beschleunigen, teilen wir das Navigation SDK for Android und das Driver SDK for Android in zwei verschiedene Binärdateien auf:

• Navigation SDK for Android, das Navigations- und Routingfunktionen für Ihre Fahrer bietet.
• Das Driver SDK for Android, mit dem Sie die zustandsorientierten Fleet Engine-Webdienste für den Fortschritt und die Zuweisung von Fahrten oder Aufgaben nutzen können.

Das Driver SDK for Android hat eine erforderliche Abhängigkeit vom Navigation SDK for Android für die wichtigsten Routingfunktionen.

Welche Änderungen gibt es?

Die wichtigsten Änderungen in Version 3 sind:

• Zwei Binärdateien statt einer.
• Klarere Paketdefinitionen für Driver SDK for Android-Klassen.
• Das Navigation SDK for Android enthält das Maps SDK for Android als Teil des Pakets (ab Navigation SDK for Android v2).
  • So können Karten- und Navigationsfunktionen auf derselben Karte verwendet werden (z. B. das Zeichnen von Polylinien auf einer NavigationView). Außerdem wird der Speicherverbrauch reduziert, da nur eine Karte anstelle von zwei verwendet wird.
  • Das Navigation SDK for Android 3.0 bietet nicht den vollen Funktionsumfang des Navigation SDK for Android. Mit Version 3.2 werden die meisten Probleme behoben. Weitere Informationen finden Sie unter Was kann ich tun und wann?.
• Protokollierung, die es uns erleichtert, Probleme zu beheben, die bei Ihnen auftreten.

Die folgenden Methoden wurden ebenfalls in Version 3 entfernt. Sie waren zuvor als veraltet markiert und es gibt bereits eine alternative Lösung:

• Die folgenden Nav/Driver SDK-Methoden wurden in Version 1.16, die am 10. August 2020 veröffentlicht wurde, eingestellt und in Version 3.0 entfernt:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Der Vollständigkeit und Klarheit halber sei darauf hingewiesen, dass bei der Umstellung von v1 auf v2 eine Reihe von Methoden entfernt wurden. Die meisten davon waren Konsolidierungen von doppelten Klassen zwischen dem Navigation SDK for Android und dem Maps SDK for Android. Weitere Informationen zu diesen Änderungen finden Sie im Migrationsleitfaden.

Einstellung des Driver SDK for Android und des Navigation SDK for Android v1.x

Das Nav/Driver SDK v1 wurde 2018 veröffentlicht. Da wir bald die Versionen v3 veröffentlichen, ist es an der Zeit, v1 einzustellen, um die Unterstützung vieler Hauptversionen zu vermeiden.

Die Zeit, die wir dadurch sparen, dass wir diese zusätzliche Version nicht mehr unterstützen müssen, können wir nutzen, um die aktuelle Hauptversion besser zu unterstützen und mehr Funktionen zu entwickeln, die für unsere Kunden wichtig sind.

Das Nav/Driver SDK v1.x ist daher jetzt veraltet und wird nach dem 21. Juni 2022 nicht mehr gewartet.

Informationen zur Funktionsweise von Einstellungen in SDK-Versionen

Ende des Supports für Android 21 und 22 für das Navigation SDK und das Driver SDK

v1.15.3 (9. Oktober 2020)

API-Updates

• Das Driver SDK abonniert jetzt das Navigation SDK für Verkehrsaktualisierungen, die an die Fleet Engine API gesendet werden.

Stabilitätsverbesserungen und Fehlerkorrekturen

• Ein Fehler wurde behoben, der zum Absturz der gRPC-Laufzeit führte.

v1.15.2

Funktionen

Möglichkeit hinzugefügt, dauerhafte Benachrichtigungen zu beenden. Wenn die Standortberichterstattung in der Fleet Engine-Instanz beendet wird, wird die Routenführung in Navigator beendet, alle Navigationslistener werden abgemeldet und NavigationFragment oder NavigationView wird pausiert.

Stabilitätsverbesserungen und Fehlerkorrekturen

• Ein Fehler wurde behoben, der dazu führte, dass eine Ausnahme ausgelöst wurde, wenn die Fleet Engine-Instanz gelöscht wurde.

Version 1.15.1 (12. Mai 2020)

Funktionen

Eine vorläufige Analyse der Daten aus Version 1.15.0 ergab deutliche Verbesserungen bei der stabilen Standortberichterstattung (weniger „festgefahrene“ Standorte). Durch diesen Patch-Fix kann die verbesserte Standortberichterstellung fortgesetzt werden. Das ANR-Problem stand nicht im Zusammenhang mit diesen Verbesserungen.

Stabilitätsverbesserungen und Fehlerkorrekturen

• Ein Fehler wurde behoben, der manchmal dazu führte, dass in der Verbraucher-App eine gerade Linie am Anfang der Route angezeigt wurde.
• Ein Fehler wurde behoben, der zu einem ANR führen konnte, wenn Standorte vom SDK gemeldet wurden. Dies ist auf onArrival()-Verbesserungen zurückzuführen, die anfällig für Sperrkonflikte waren. Wir konnten ANRs unter bestimmten Umständen zuverlässig reproduzieren und haben festgestellt, dass das Problem durch die Korrekturen behoben wurde. Die modifizierte Test-App, mit der die ANR-Fehler erzeugt wurden, lief nach der Korrektur acht Stunden lang ohne ANR-Fehler.

v1.15.0 (23. März 2019)

Funktionen

• Der Status der Navigationsanleitung wurde bei Start-, Abweichungs- und Ankunftsereignissen eingeführt, um die Standortverfolgung von Fahrzeugen zu verbessern.
• Es ist jetzt möglich, weiterhin auf Straßen ausgerichtete Standorte zu erhalten, unabhängig vom Navigationsstatus.
• Es wurden zusätzliche Informationen zu Standorten vor dem Road-Snapping hinzugefügt, z. B. zur Genauigkeit.

Stabilitätsverbesserungen und Fehlerkorrekturen

• Die minSdkVersion für das NavSDK wurde auf 19 erhöht.
• Ein Fehler wurde behoben, der dazu führte, dass Namen von Wegpunkten mit Breiten- und Längengrad nicht berücksichtigt wurden, wenn das serverseitige Reverse-Geocoding fehlschlug.

Version 1.14.2 (2. Februar 2019)

Funktionen

• Verhindert, dass das DriverSDK 0,0-Standorte an Fleet Engine sendet. Das verbessert die Standortangaben für die Freigabe von Fahrten und die Zuweisung.
• Zusätzliche Protokollierung zur Verbesserung von Problemen mit dem Standort und zur Reduzierung von Fallbacks für die Routenfreigabe.
• Wiederholte Aufrufe von setLocationReportingInterval() ignorieren, sofern sich das Intervall nicht ändert.
• Aktualisierte Javadocs für die Methode setReportingInterval(), um zu verhindern, dass diese Methode im Vergleich zu den verwendeten Intervallen zu häufig aufgerufen wird.
• Die Zuverlässigkeit der Standortbestimmung wurde in API 29 verbessert.

v1.13.0

Stabilitätsverbesserungen und Fehlerkorrekturen

• Fügt eine Abhängigkeit von okhttp hinzu, die Clients ihren Gradle-Builds hinzufügen müssen.

v1.11.7 (18. Oktober 2019)

Stabilitätsverbesserungen und Fehlerkorrekturen

• Standortaktualisierungen werden jetzt fortgesetzt, nachdem onArrival() für ein bestimmtes Ziel ausgelöst wurde.
• Die Standardbenachrichtigung (ein konstanter String im Free Nav-Modus) entspricht dem Farbschema, das für die Navigationsbenachrichtigungen festgelegt ist. Weitere Informationen finden Sie unter Gemeinsam genutzte persistente Benachrichtigungen.
• Ein Problem wurde behoben, bei dem ein verzögertes Ereignis zur Aktualisierung des Standorts zu einer fälschlichen Aktualisierung des Standorts führen konnte, was Artefakte wie eine gerade Linie am Anfang einer Route verursachte.

v1.11.6 (4. Oktober 2019)

API-Updates

• Es wurden eine Reihe von Änderungen eingeführt, die dafür sorgen, dass das Driver SDK nach einem Netzwerkausfall schnell wieder Standortaktualisierungen vornimmt. Sobald die Netzwerkverbindung wiederhergestellt ist, werden Standortaktualisierungen beim nächsten geplanten Standortupdate wieder aufgenommen.

Stabilitätsverbesserungen und Fehlerkorrekturen

• setVehicleState() gibt jetzt sofort einen Wert zurück. Die Aktualisierung von FleetEngine erfolgt jetzt in einem Hintergrundthread. Behebt ein ANR-Problem („App antwortet nicht“).
• Ein Problem wurde behoben, bei dem Routen, die über die Funktion zum Teilen von Routen geteilt wurden, in älteren Versionen des Consumer SDK als gerade Linie angezeigt wurden. So wird sichergestellt, dass dem Fahrer-SDK keine einmaligen Wegpunkte zur Route hinzugefügt werden.