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.
  • Bei Apps, die das Driver SDK verwenden, muss die Desugaring-Funktion aktiviert sein. 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 sichtbar 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)

Änderung der Abhängigkeit

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

Änderung der Abhängigkeit

  • 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 werden nur noch Android API-Levels 23 und höher unterstützt. 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)

Änderung der Abhängigkeit

  • Aktualisieren Sie die Nav SDK-Abhängigkeit 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 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 SDK-Stabilität 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.

Async getRemainingVehicleStops

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.

18. Oktober 2021 – Einstellung der Unterstützung für API-Level 23, 24 und 25

Ankündigung vom 18. Oktober lesen

Aufgrund von Änderungen an unseren internen Abhängigkeiten werden Android API-Level 23, 24 und 25 (Android 6, 7.0 und 7.1) ab dem dritten Quartal 2022 nicht mehr in neuen Versionen der Navigations- und Fahrer-SDKs für Android unterstützt.

Navigations- und Fahrer-SDKs für Android-Versionen, die ab dem dritten Quartal 2022 veröffentlicht werden, werden nur auf Geräten mit mindestens Android API-Level 26 unterstützt.

App-Versionen, die mit Version 4.x oder niedriger des Navigations- und Fahrer-SDKs für Android erstellt wurden, funktionieren weiterhin auf Geräten mit Android API-Level 25 und niedriger.

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.

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.

Widerrufsmitteilung lesen

Die kommende Version 4.0 des Navigation SDK for Android und des Driver SDK for Android unterstützt mindestens [Android 6.0 (API-Level 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. Die aktuell unterstützte Mindestversion ist Android 5.0 (API-Level 21). Wir gehen davon aus, dass Version 4.0 im 4. Quartal 2021 veröffentlicht wird. Das bedeutet:

  • App-Versionen, die mit Versionen vor v4.x erstellt wurden, funktionieren weiterhin auf Geräten mit Android 21 und 22. Ihre Fahrer-Apps, in die unsere aktuellen SDKs eingebunden sind, funktionieren weiterhin auf Geräten mit Android 21 und höher. Das ist unverändert.
  • App-Versionen, die mit dem Driver SDK for Android und dem Navigation SDK for Android Version 4.x (voraussichtlich 4. Quartal 2021, Änderungen vorbehalten) erstellt wurden und danach erstellt werden, können nicht auf Geräten mit Android 21 und 22 installiert werden. Version 4.x wird mindestens mit Android 6.0 (API-Level 23) ausgeführt. Daher können Versionen Ihrer App, die mit der kommenden Version 4.x erstellt wurden, nur von Fahrern mit Geräten mit Android 23 und höher empfangen werden. Das bedeutet, dass sowohl unsere SDK-Änderungen als auch alle von Ihnen vorgenommenen App-Änderungen nicht für Fahrer mit Geräten mit Android 21 und 22 sichtbar sind.

In der folgenden Tabelle werden die Versionen des Navigation SDK for Android 3 und des Driver SDK for Android 3 beschrieben, auf die Sie ein Upgrade durchführen sollten, sowie deren Verfügbarkeit.

Welche Funktionen der Driver-Plattform verwenden Sie? Nutzen Sie diese Funktionen? Die ersten verfügbaren Versionen, auf die Sie ein Upgrade durchführen sollten, sind: Voraussichtliche Verfügbarkeit
(Änderungen vorbehalten)		 Links zur Migration
Nur Navigation
(NavSDK-Methoden)		 Nein NavSDK v3.0.1 Jetzt Leitfaden
Ja NavSDK v3.5 (prognostiziert) Sept. 2021
Navigation und Fleet Engine-Tracking (NavSDK- und DriverSDK-Methoden) Nein Nav SDK v3.0 und Driver SDK v3.0 Migrationsanleitung für Treiberversion 3.0 nach der Veröffentlichung verfügbar
Ja NavSDK v3.x und DriverSDK v3.0

Wenn Sie die entfernten Methoden weiterhin verwenden möchten, können Sie bei Version 1.x bleiben. Sie erhalten dann aber nach dem 21. Juni 2022 keinen Support mehr und es werden keine Wartungsarbeiten mehr durchgeführt (siehe nächster Abschnitt).

Wir empfehlen die Migration zu Version 3.x. Das bedeutet:

* Die letzte Version von v1.x wird im 4. Quartal 2021 veröffentlicht. Ab diesem Zeitpunkt ist v1 dann „feature frozen“.

* Dieser letzte Release kann danach noch sechs Monate lang, bis zum 21. Juni 2022, gepatcht werden. Danach können wir keine Fehlerberichte oder Funktionsanfragen mehr für Version 1.x bearbeiten.

Sehen Sie sich die folgende Tabelle und den [Migrationsleitfaden](/maps/documentation/navigation-sdk-android/v2/migration) an, um sich über die Änderungen zu informieren.

Bis wann kann ich was tun?

Wenn Sie derzeit… Nutzen Sie diese Funktionen? So führen Sie ein sofortiges Upgrade durch: Umstellung im September 2021 Links zur Migration
v1.x
(keine Verwendung von FleetEngine.java / Driver-Funktion) 		Nein NavSDK 3.0 Leitfaden
Ja Keine Option NavSDK 3.x
v1.x
(mit FleetEngine.java / Driver-Funktion)		 Nein Keine Option NavSDK 3.x +
DriverSDK 3.x		 Der obige Leitfaden sowie der Migrationsleitfaden für Driver 3.0, der zum Zeitpunkt der Veröffentlichung verfügbar ist.
Ja

Wir empfehlen Ihnen, Ihre Fahrer mit Geräten mit Android 21 und 22 auf eine neuere Android-Version (mindestens Android 6.0) umzustellen, bevor Sie das Driver SDK for Android und das Navigation SDK for Android Version 4.x oder höher in Ihre Fahrer App einbinden.

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

Möglichkeit hinzugefügt, 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 für Start-, Abweichungs- und Ankunftsereignisse 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 navsdk 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.
  • Wiederholte Aufrufe von setLocationReportingInterval() werden ignoriert, 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 dem Fehler „App antwortet nicht“ (ANR) 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.