Versionshinweise zum Treiber-SDK für Android

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

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

Gemäß der Richtlinie zur Unterstützung von mobilen Betriebssystemversionen wird die Unterstützung für Android 6 und 7 (API-Level 23, 24 und 25) in den nächsten Hauptversionen des Driver SDK for Android eingestellt.

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

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

Geben Sie in den Build-Abhängigkeiten Ihrer Anwendung eine Version des Driver SDK für Android an, um festzulegen, wann Sie das Mindest unterstützte Betriebssystem für neue Versionen Ihrer App erhöhen.

Version 6.0.0 (25. November 2024)

Fehlerkorrekturen

• Das Problem, bei dem Fahrer gRPC-Fehler mit dem Code „INTERNAL“ und der Meldung „Panic! Das ist ein Fehler!“
• Interne Verbesserungen, um Verbindungsfehler bei Standortaktualisierungen zu reduzieren, insbesondere wenn das Gerät das Netzwerk wechselt. Die Funktion wird nach der Integration der Version schrittweise eingeführt (beginnend bei 0%).`

API-Updates

• Die eingestellte Benutzeroberfläche StatusListener wurde entfernt.

Abhängigkeits- und Konfigurationsänderungen

• Abhängigkeit von glide:cronet-integration in der POM.xml entfernen
• Die unterstützten Versionsbereiche des Navigation SDK wurden auf Version 5.x aktualisiert.
• Ab Version 6.0.0 des Driver SDK for Android müssen Apps auf Kotlin 2.0 umgestellt werden.
• „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.

Version 5.99.0 (20. September 2024)

Fehlerkorrekturen

• Das Problem, bei dem Fahrer gRPC-Fehler mit dem Code „INTERNAL“ und der Meldung „Panic! Das ist ein Fehler!“ Die Funktion wird nach der Integration nach und nach eingeführt (beginnend bei 0%).
• Interne Verbesserungen, um Verbindungsfehler bei Standortaktualisierungen zu reduzieren, insbesondere wenn das Gerät das Netzwerk wechselt. Die Funktion wird nach der Integration der Version nach und nach eingeführt (beginnend bei 0%).`

Abhängigkeits- und Konfigurationsänderungen

• Abhängigkeit von glide:cronet-integration in der POM.xml entfernen

Version 5.0.0 (12. September 2023)

Abhängigkeits- und Konfigurationsänderungen

• Das Navigation SDK wurde auf Version 5.x aktualisiert.
• minSdkVersion auf API 23 umgestellt
• Die Kotlin-Version wurde auf 1.9.0 aktualisiert.
• Abhängigkeit von Raum hinzugefügt. * Apps, die das Driver SDK verwenden, müssen jetzt targetSdkVersion der API 31 oder höher haben.
• Für Apps, die das Driver SDK verwenden, muss jetzt die Unterstützung der Java 8-Bibliothek 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.
• Für Apps, die das Driver SDK verwenden, muss die Desugaring-Funktion aktiviert werden. Eine Anleitung finden Sie unter https://developer.android.com/studio/write/java8-support#library-desugaring.

Fehlerkorrekturen

• Problem mit der Synchronisierung von „disableLocationTracking“ behoben
• Neue DriverStatusListener-Schnittstelle eingeführt, die bei Statusaktualisierungen für Ausnahmen eine Ursache meldet.
• Problem mit Fahrern, die stehengeblieben sind, behoben (verfügbar ab Version 4.99.0).

Version 4.99.0 (9. August 2023)

• Unterstützung mehrerer Versionen für die NavSDK-Abhängigkeit. ** Unterstützt Version 4.5.0 bis einschließlich Version 5.0.0.
• Verhindern, dass die geschätzte Ankunftszeit von selbst sinkt, wenn das Fahrzeug steht. Diese Änderung wird nach und nach als Test eingeführt. Sie wird also nicht gleichzeitig für alle Apps verfügbar sein.

Version 4.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.

Version 4.4.3 (20. März 2023)

Abhängigkeit ändern

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

Version 4.4.2 (15. Februar 2023)

Fehlerkorrekturen

• Die Zeit für die Netzwerkwiederherstellung wird verbessert, wenn das SDK ein vorübergehendes Verbindungsproblem erkennt. Dies ist eine experimentelle Lösung.

• UpdateVehicle-Anfragen, die nur einen „Raw“-Standort enthalten, werden verworfen.

• Behebung einer Race-Bedingung in der ALPHA API „Routenübersicht“.

Version 4.4.1 (18. November 2022)

Fehlerkorrekturen

• Ein Fehler in der Logik für den Traffic-Upload wurde behoben.

Weitere Änderungen

• Interne Verbesserungen bei Anfrageheadern und Statuscode-Berichten.

Version 4.4.0 (21. September 2022)

Fehlerkorrekturen

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

Abhängigkeit ändern

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

Version 4.3.0 (24. August 2022)

Interne Verbesserungen.

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

Für unsere neueste SDK-Version (v4.2.0) bieten wir ein zusätzliches Jahr lang Support für Apps, die auf Android 5 laufen, sowohl für API-Level 21 als auch 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 nach 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. Wir können nicht garantieren, dass die SDKs ordnungsgemäß funktionieren.

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.

Version 4.2.0 (8. Juni 2022)

Abhängigkeit ändern

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

Version 4.1.0 (28. April 2022)

API-Updates

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

Version 4.0.0 (29. November 2021)

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

API-Updates

Bei dieser Version wurden die folgenden Änderungen am Driver SDK for Android vorgenommen.

Änderung an 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

Die Überwachung und Berichterstellung von Abstürzen wurde hinzugefügt, um die Stabilität des SDK zu verbessern. Diese Funktion ist standardmäßig aktiviert. Sie können sie jedoch deaktivieren, indem Sie setAbnormalTerminationReportingEnabled() aufrufen und ihr den Wert false übergeben, bevor Sie das SDK initialisieren.

• Die Funktion setAbnormalTerminationReportingEnabled wurde zu DriverApi hinzugefügt.

Async getRemainingVehicleStops

• Die Funktion getRemainingVehicleStops von DeliveryVehicleReporter gibt jetzt eine Future<List<VehicleStop>> anstelle einer List<VehicleStop> zurück.

Authentifizierung

Unnötige Properties wurden aus der AuthTokenContext-Benutzeroberfläche entfernt. ServiceType wurde eingestellt. Sie müssen jetzt nur noch Ansprüche für die enthaltene Fahrzeug-ID und Aufgaben-ID abrufen, anstatt sich auf ServiceType zu verlassen.

• ServiceType wurde aus AuthTokenContext entfernt.

• getServiceType() wurde aus AuthTokenContext entfernt.

• setServiceType wurde aus AuthTokenContext.Builder entfernt.

18. Oktober 2021 – Einstellung der Unterstützung 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ät und Fehlerkorrekturen

Melden Sie PERMISSION_DENIED-Fehler, anstatt sie als Verbindungsfehler zu klassifizieren.

Ankündigung der Einstellung (21. Juni 2021)

In dieser Mitteilung werden die Einstellung des Driver SDK for Android und des Navigation SDK for Android ab dem oben genannten Datum beschrieben. Diese Mitteilung wurde auch als Servicemitteilung (Mandatory Service Announcement, MSA) an betroffene Kunden gesendet.

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

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 Ihren Fahrern Navigations-/Routingfunktionen bietet.
• Driver SDK for Android, mit dem Sie zustandsorientierte Fleet Engine-Webdienste für den Fortschritt und die Zuweisung von Fahrten oder Aufgaben nutzen können.

Das Driver SDK for Android ist für die wichtigsten Routingfunktionen vom Navigation SDK for Android abhängig.

Welche Änderungen gibt es?

Die wichtigsten Änderungen in Version 3 sind:

• Zwei Binärdateien statt einer.
• Deutlichere Paketdefinitionen für Klassen des Driver SDK for Android.
• Das Navigation SDK for Android enthält das Maps SDK for Android als Teil der Verpackung (Stand: Navigation SDK for Android Version 2).
  • So können Karten und Navigationsfunktionen auf derselben Karte nebeneinander existieren (z. B. Polylinien in einer NavigationView zeichnen) und die Speichernutzung wird reduziert, da statt zwei Karten nur eine verwendet wird.
  • Das Navigation SDK for Android 3.0 bietet nicht den vollen Funktionsumfang des Navigation SDK for Android. Mit Version 3.2 werden jedoch die meisten Probleme behoben. Weitere Informationen finden Sie unter Was kann ich tun und wann?
• Protokolle, die uns die Fehlerbehebung erleichtern.

Die folgenden Methoden wurden ebenfalls in Version 3 entfernt, da sie zuvor als veraltet markiert wurden und für die es bereits eine alternative Lösung gibt:

• Die folgenden Nav/Driver SDK-Methoden wurden in Version 1.16 eingestellt, die am 10. August 2020 veröffentlicht wurde, und in Version 3.0 entfernt:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Zur Vollständigkeit und Klarheit: Bei der Umstellung von Version 1 auf Version 2 wurden einige Methoden entfernt. Bei den meisten davon handelt es sich um Zusammenführungen doppelter 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 1.x

Das Nav/Driver SDK v1 wurde 2018 veröffentlicht. Da unsere Version 3-Versionen bald veröffentlicht werden, ist es an der Zeit, Version 1 einzustellen, um die nicht nachhaltige Unterstützung vieler Hauptversionen zu vermeiden.

Da wir diese zusätzliche Version nicht mehr unterstützen müssen, können wir die neueste Hauptversion besser unterstützen und mehr Funktionen entwickeln, die für unsere Kunden wichtig sind.

Das Nav/Driver SDK v1.x wird daher eingestellt und nach dem 21. Juni 2022 nicht mehr gepflegt.

Hier finden Sie weitere Informationen zur Einstellung von SDK-Versionen.

Ende des Supports für das Navigations- und Fahrer-SDK für Android 21 und 22

Version 1.15.3 (9. Oktober 2020)

API-Updates

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

Stabilität und Fehlerkorrekturen

• Ein Absturz der gRPC-Laufzeit wurde behoben.

v1.15.2

Funktionen

Es ist jetzt möglich, dauerhafte Benachrichtigungen zu beenden. Wenn die Standortermittlung in der Fleet Engine-Instanz beendet wird, wird die Navigation in Navigator beendet, alle Navigations-Listener werden abgemeldet und NavigationFragment oder NavigationView wird pausiert.

Stabilität und Fehlerkorrekturen

• Ein Fehler wurde behoben, durch den 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 von 1.15.0 hat erhebliche Verbesserungen bei der Zuverlässigkeit der Standortberichte ergeben (Reduzierung der Anzahl der „festgefahrenen“ Standorte). Mit diesem Patch können die verbesserten Standortberichte fortgesetzt werden. Das ANR-Problem hatte nichts mit diesen Verbesserungen zu tun.

Stabilität und Fehlerkorrekturen

• Ein Fehler wurde behoben, durch den in der App für Nutzer manchmal eine gerade Linie am Anfang der Route angezeigt wurde.
• Ein Fehler wurde behoben, der zu einer ANR führen konnte, wenn Standorte vom SDK gemeldet wurden. Dies war auf Verbesserungen bei onArrival() zurückzuführen, die anfällig für Sperrkonflikte waren. Wir konnten ANRs unter bestimmten Umständen zuverlässig reproduzieren und bestätigen, dass die Fehlerbehebungen das Problem behoben haben. Die geänderte Test-App zum Erzeugen der ANRs lief nach der Fehlerbehebung acht Stunden lang ohne ANR.

Version 1.15.0 (23. März 2019)

Funktionen

• Der Navigationsleitstatus wurde bei Start-, Abweichungs- und Ankunftsereignissen eingeführt, um die Fahrzeugortung zu verbessern.
• Es ist jetzt möglich, unabhängig vom Navigationsstatus weiterhin an Straßen ausgerichtete Standorte zu erhalten.
• Es wurden zusätzliche Informationen zu Orten hinzugefügt, die vor dem Anpassen an Straßen aufgenommen wurden, z. B. zur Genauigkeit.

Stabilität und Fehlerkorrekturen

• Die minSdkVersion für das Navigations-SDK wurde auf 19 erhöht.
• Ein Fehler wurde behoben, durch den die Namen von Wegpunkten mit Lat/Lng nicht berücksichtigt wurden, wenn das serverseitige Reverse-Geocoding fehlgeschlagen ist.

Version 1.14.2 (2. Februar 2019)

Funktionen

• Verhindert, dass das DriverSDK Standorte mit 0,0 an Fleet Engine sendet (bessere Eingaben für die Standortfreigabe und die Zuweisung).
• Zusätzliche Protokollierung zur Verbesserung von Problemen mit nicht aktualisierten Standorten und zur Verringerung von Ausfällen bei der Freigabe von Fahrten.
• Ignorieren Sie wiederholte Aufrufe von setLocationReportingInterval(), es sei denn, das Intervall ändert sich.
• Die Javadocs für die Methode setReportingInterval() wurden aktualisiert, um wiederholte Aufrufe dieser Methode mit hoher Frequenz im Verhältnis zu den verwendeten Intervallen zu verhindern.
• Die Zuverlässigkeit der Standortermittlung in API 29 wurde verbessert.

v1.13.0

Stabilität und Fehlerkorrekturen

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

Version 1.11.7 (18. Oktober 2019)

Stabilität und Fehlerkorrekturen

• Standortaktualisierungen werden jetzt fortgesetzt, nachdem onArrival() für ein bestimmtes Ziel ausgelöst wurde.
• Die Standardbenachrichtigung (ein konstanter String im Modus „Kostenlose Navigation“) entspricht dem Farbschema, das für die Navigationsbenachrichtigungen festgelegt ist. Weitere Informationen finden Sie unter Gemeinsam genutzte persistente Benachrichtigungen.
• Ein Problem wurde behoben, durch das ein verzögertes Ereignis für die Standortaktualisierung zu einer falschen Standortaktualisierung führen konnte, was zu Artefakten wie einer geraden Linie am Anfang einer Route führte.

Version 1.11.6 (4. Oktober 2019)

API-Updates

• Es wurden mehrere Änderungen eingeführt, durch die das Driver SDK Standortaktualisierungen nach einem Netzwerkfehler schnell fortsetzt. Sobald die Netzwerkverbindung wiederhergestellt ist, werden Standortaktualisierungen beim nächsten geplanten Standortupdate fortgesetzt.

Stabilität und Fehlerkorrekturen

• setVehicleState() wird jetzt sofort zurückgegeben. Die Aktualisierung der FleetEngine erfolgt jetzt in einem Hintergrund-Thread. Ein Problem mit ANRs (App antwortet nicht) wurde behoben.
• Ein Problem wurde behoben, bei dem bei älteren Versionen des Consumer SDKs die Routen für die Freigabe von Fahrten als gerade Linie angezeigt wurden. Damit wird sichergestellt, dass der Route keine einmaligen Wegpunkte vom Driver SDK hinzugefügt werden.