Versionshinweise zum Treiber-SDK für Android

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

Version 5.0.0 (12. September 2023)

Abhängigkeits- und Konfigurationsänderungen

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

Fehlerkorrekturen

  • Ein Problem mit der Synchronisierung von „disableLocationTracking“ wurde behoben.
  • Einführung einer neuen DriverStatusListener-Schnittstelle, die eine Ursache bei Aktualisierungen des Ausnahmestatus meldet.
  • Problem behoben, bei dem Fahrer nicht bewegt wurden (verfügbar ab Version 4.99.0).

Version 4.99.0 (9. August 2023)

  • Unterstützt eine Reihe von Versionen für die NavSDK-Abhängigkeit. ** Unterstützt Version 4.5.0 bis Version 5.0.0 (ohne Ausnahme).
  • Verhindern, dass sich die voraussichtliche Ankunftszeit automatisch abnimmt, wenn das Fahrzeug steht. Diese Änderung wird erst nach und nach zu Testzwecken eingeführt. Sie wird daher nicht für alle Apps gleichzeitig eingeführt.

Version 4.5.0 (12. Mai 2023)

  • Aktualisierung der Abhängigkeit des Navigation SDK 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ängigkeitsänderung

  • Aktualisieren Sie die Abhängigkeit des Navigation SDK auf v4.4.1.

Version 4.4.2 (15. Februar 2023)

Fehlerkorrekturen

  • Verbessern Sie die Zeit für die Netzwerkwiederherstellung, wenn im SDK ein vorübergehendes Verbindungsproblem auftritt. Diese Funktion wird derzeit als Test eingeführt.

  • Verwerfen Sie UpdateVehicle-Anfragen, die nur einen Rohdatenspeicherort enthalten.

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

Version 4.4.1 (18. November 2022)

Fehlerkorrekturen

  • Ein Fehler in der Logik zum Hochladen von Traffic wurde behoben.

Weitere Änderungen

  • Interne Verbesserungen bei Anfrageheadern und Statuscodeberichten.

Version 4.4.0 (21. September 2022)

Fehlerkorrekturen

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

Abhängigkeitsänderung

  • Aktualisieren Sie die Abhängigkeit des Navigation SDK auf v4.2.2.

Version 4.3.0 (24. August 2022)

Interne Verbesserungen.

Mitteilung: Unterstützung für Android 5 wird eingestellt (21. Juli 2022)

Für unsere neueste SDK-Version (Version 4.2.0) bieten wir ein weiteres Jahr Support für Apps, die unter Android 5 ausgeführt werden, für die API-Level 21 und 22.

Was das bedeutet:

  • Das Navigation SDK und das Driver SDK, das in Ihren Android-Apps ausgeführt wird, unterstützen bis zum 30. Juni 2023 mindestens Android 5 (API-Level 21).
  • Ab dem 30. Juni 2023 unterstützen wir nur noch Android API-Level 23 oder höher. Ab diesem Datum werden die Android API-Level 21 und 22 in allen SDK-Versionen nicht mehr unterstützt. Das bedeutet, dass Programmfehler im Zusammenhang mit Android 21 oder 22 in keiner SDK-Version (einschließlich 4.x) behoben werden und wir keine Garantie dafür geben, dass die SDKs korrekt funktionieren.

Mit diesem Hinweis wird die Benachrichtigung, dass die Unterstützung für Android 21 und 22 vom 21. Juni 2021 eingestellt wird, und die Einstellung für Android 23, 24 und 25 vom 18. Oktober 2021 überschrieben.

Version 4.2.0 (8. Juni 2022)

Abhängigkeitsänderung

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

Version 4.1.0 (28. April 2022)

API-Updates

  • Die Eigenschaft parentId des Task-Objekts wurde in trackingId umbenannt. Das alte Attribut ist vorerst noch vorhanden, wurde aber eingestellt.

  • Einige Rückgabetypen wurden von Future zum spezifischeren ListenableFuture und von List zum spezifischeren ImmutableList geändert.

Version 4.0.0 (29. November 2021)

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

API-Updates

In diesem Release wurde das Driver SDK for Android mit den folgenden Änderungen aktualisiert.

Änderung an der VehicleStops API

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

  • Neuer Kurs 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

Absturzmonitoring und -berichte wurden hinzugefügt, um die SDK-Stabilität zu verbessern. Diese Funktion ist standardmäßig aktiviert. Sie können sie aber deaktivieren, wenn Sie setAbnormalTerminationReportingEnabled() aufrufen und vor dem Initialisieren des SDK den Wert false übergeben.

Asynchrone getRemainingVehicleStops

Authentifizierung

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

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

Mitteilung vom 18. Oktober lesen

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

Navigations- und Treiber-SDKs für Android-Versionen, die ab dem dritten Quartal 2022 veröffentlicht werden, unterstützen nur Geräte mit Android API-Level 26 oder höher.

App-Versionen, die mit Version 4.x oder niedriger des Navigations- und Treiber-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

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

API-Updates

Folgende Methoden wurden hinzugefügt:

DeliveryDriverApi.getDriverSdkVersion()

Stabilität und Fehlerkorrekturen

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

Ankündigung zur Einstellung (21. Juni 2021)

In dieser Mitteilung werden die Einstellungen des Driver SDK for Android und des Navigation SDK for Android ab dem oben genannten Datum beschrieben. Diese Mitteilung wurde auch als Servicemitteilung an betroffene Kunden gesendet.

Um die Kundenintegration zu vereinfachen und schneller nützliche Funktionen bereitstellen zu können, teilen wir das Navigation SDK for Android und das Driver SDK for Android in zwei verschiedene Binärprogramme auf:

  • Navigation SDK for Android, das Navigations-/Routingfunktionen für Ihre Fahrer bietet.
  • Driver SDK for Android, mit dem Sie zustandsorientierte Webdienste von Fleet Engine für den Fahrt- oder Aufgabenfortschritt und die Zuweisung nutzen können.

Beachten Sie, dass für das Driver SDK for Android eine erforderliche Abhängigkeit vom Navigation SDK for Android für grundlegende Routingfunktionen besteht.

Welche Änderungen gibt es?

Die wichtigsten Änderungen in Version 3 sind:

  • Zwei Binärprogramme statt eines.
  • Klarere Paketdefinitionen für Driver SDK for Android-Klassen.
  • Das Navigation SDK for Android enthält das Maps SDK for Android als Teil der Paketerstellung (ab Version 2: Navigation SDK for Android).
    • So können Karten und Navigationselemente auf derselben Karte nebeneinander verwendet werden (z. B. Polylinien in einer Navigationsansicht zeichnen). Außerdem wird die Speichernutzung reduziert, da statt zwei Karten nur eine Karte verwendet wird.
    • Navigation SDK for Android 3.0 hat nicht alle Funktionen des Navigation SDK for Android, aber Version 3.2 löst die meisten Probleme hier. Unter Was kann ich tun und wann? finden Sie weitere Informationen.
  • Protokollierung, die uns die Behebung eventueller Probleme erleichtert.

Die folgenden Methoden wurden ebenfalls in Version 3 entfernt, da sie zuvor als eingestellt 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, am 10. August 2020 veröffentlicht und in Version 3.0 entfernt:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Beachten Sie zur Vollständigkeit und Klarheit, dass bei der Umstellung von Version 1 auf Version 2 eine Reihe von Methoden entfernt wurden. Meistens waren das die Konsolidierungen doppelter Klassen zwischen dem Navigation SDK for Android und dem Maps SDK for Android. Weitere Informationen zu diesen Änderungen finden Sie in der Migrationsanleitung.

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

Das Nav/Driver SDK v1 wurde 2018 veröffentlicht. Da unsere v3-Versionen bald veröffentlicht werden, ist es an der Zeit, v1 einzustellen, um zu vermeiden, dass viele Hauptversionen nicht mehr unterstützt werden.

Die Zeitersparnis durch den Wegfall der Unterstützung dieser zusätzlichen Version ermöglicht es uns, die neueste Hauptversion besser zu unterstützen und mehr Funktionen zu entwickeln, die unseren Kunden wichtig sind.

Version 1.x des Nav/Driver SDK wurde daher eingestellt und wird nach dem 21. Juni 2022 nicht mehr unterstützt.

Nehmen Sie sich einen Moment Zeit, um zu erfahren, wie Einstellungen in SDK-Versionen funktionieren.

Widerrufene Mitteilung lesen

Die neue Version 4.0 des Navigation SDK for Android und des Driver SDK for Android unterstützen 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 die Veröffentlichung von Version 4.0 im 4. Quartal 2021 erfolgt. Das bedeutet:

  • App-Versionen, die mit älteren Versionen als 4.x erstellt wurden, funktionieren weiterhin auf Geräten mit Android 21 und 22. Deine Treiber-Apps, die unsere aktuellen SDKs integriert haben, funktionieren weiterhin auf Geräten mit Android 21 oder höher.
  • App-Versionen, die mit dem Driver SDK for Android und dem Navigation SDK for Android 4.x erstellt wurden (vorgesehen für das 4. Quartal 2021, können sich jederzeit ändern) und danach nicht mehr auf Geräten mit Android 21 und 22 installiert werden können.Version 4.x ist unter Android 6.0 (API-Level 23) mindestens erforderlich. Auf Geräten mit Android 2 und höher können App-Treiber also nur auf Geräten mit Version 2 oder höher installiert sein.

In der folgenden Tabelle werden die Versionen von Navigation SDK for Android v3 und Driver SDK for Android v3 erläutert, auf die Sie ein Upgrade durchführen sollten. Dort wird auch angegeben, wann diese verfügbar sind.

Welche Funktionen der Treiberplattform verwenden Sie? Verwenden Sie diese Funktionen? Die ersten verfügbaren Versionen, auf die Sie ein Upgrade durchführen sollten, sind... Voraussichtliche Verfügbarkeit
(Änderungen vorbehalten)		 Migrationslinks
Nur Navigation
(NavSDK-Methoden)		 Nein NavSDK v3.0.1 Jetzt Leitfaden
Ja NavSDK Version 3.5 (prognostiziert) Sept. 2021
Navigation und Fleet Engine Tracking (NavSDK- und DriverSDK-Methoden) Nein Nav SDK Version 3.0 und Driver SDK v3.0 Migrationsanleitung für Treiber v3.0 bei Release verfügbar
Ja NavSDK v3.x und DriverSDK v3.0

Wenn Sie die entfernten Methoden weiterhin verwenden möchten, können Sie Version 1.x beibehalten, jedoch ohne Support oder Wartung nach dem 21. Juni 2022 (siehe nächster Abschnitt).

Wir empfehlen die Migration zu v3.x. Das bedeutet:

* Die letzte Veröffentlichung von v1.x wird im 4. Quartal 2021 veröffentlicht. Daher ist v1 ab diesem Zeitpunkt „eingefrorene Funktionen“.

* Diese letzte Version kann 6 Monate lang bis zum 21. Juni 2022 gepatcht werden. Danach können wir nicht mehr auf Fehler- oder Funktionsanfragen für v1.x reagieren.

In der folgenden Tabelle und im [Migrationsleitfaden](/maps/documentation/navigation-sdk-android/v2/migration) finden Sie weitere Informationen zu den Änderungen.

Was kann ich bis wann tun?

Du bist gerade auf... Verwenden Sie diese Funktionen? Jetzt upgraden Upgrade im September 2021 erforderlich Migrationslinks
v1.x
(nicht mit FleetEngine.java / Treiberfunktionalität) 		Nein NavSDK Version 3.0 Leitfaden
Ja Keine Option NavSDK 3.x
v1.x
(mit FleetEngine.java / Treiberfunktionalität)		 Nein Keine Option NavSDK 3.x +
DriverSDK 3.x		 Die obige Anleitung sowie die Migrationsanleitung für Driver v3.0, die ab dem Release verfügbar ist.
Ja

Wir empfehlen, Fahrer mit Geräten mit Android 21 und 22 zu informieren, dass sie ein Upgrade auf eine neuere Android-Version (mindestens Android 6.0) ausführen müssen, bevor du das Driver SDK for Android und das Navigation SDK for Android ab Version 4.x in deine Fahrer-App integrieren kannst.

Version 1.15.3 (9. Oktober 2020)

API-Updates

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

Stabilität und Fehlerkorrekturen

  • Ein gRPC-Laufzeitabsturz wurde behoben.

v1.15.2

Funktionen

Es besteht jetzt die Möglichkeit, dauerhafte Benachrichtigungen zu stoppen. Wenn Standortberichte in der Fleet Engine-Instanz beendet werden, wird die Navigation in Navigator beendet, alle Navigations-Listener sind nicht registriert und NavigationFragment oder NavigationView wird pausiert.

Stabilität und Fehlerkorrekturen

  • Es wurde ein Fehler 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 von Daten aus Version 1.15.0 ergab, dass die stabilen Standortberichte deutlich verbessert wurden (weniger feste Standorte). Mit dieser Fehlerkorrektur können die verbesserten Standortberichte fortgesetzt werden. Das ANR-Problem hängt nicht mit diesen Verbesserungen zusammen.

Stabilität und Fehlerkorrekturen

  • Ein Fehler wurde behoben, der manchmal dazu führte, dass am Anfang der Route in der Nutzer-App eine gerade Linie angezeigt wurde.
  • Es wurde ein Fehler behoben, der zu einem ANR-Fehler führen konnte, wenn Standorte vom SDK gemeldet wurden. Dies war auf onArrival()-Verbesserungen zurückzuführen, die anfällig für Sperrenkonflikte waren. Wir konnten ANR-Fehler unter bestimmten Umständen zuverlässig reproduzieren und prüfen, ob das Problem durch die Fehlerkorrekturen gelöst wurde. Die modifizierte Test-App zum Erstellen der ANRs lief nach der Fehlerbehebung acht Stunden ohne ANR-Fehler.

Version 1.15.0 (23. März 2019)

Funktionen

  • Einführung eines Navigationsführungsstatus bei Start-, Routenabweichungen und Ankunftsereignissen, um die Fahrzeugstandortverfolgung zu verbessern.
  • Es besteht jetzt die Möglichkeit, unabhängig vom Navigationsstatus weiterhin an Straßen ausgerichtete Standorte abzurufen.
  • Zusätzliche Informationen zu vor der Aufnahme von der Straße festgelegten Orten, z. B. zur Genauigkeit, wurden hinzugefügt.

Stabilität und Fehlerkorrekturen

  • Der Wert für minSdkVersion für navsdk wurde auf 19 erhöht.
  • Es wurde ein Fehler behoben, der dazu führte, dass Wegpunktnamen der Längen- und Breitengrade nicht berücksichtigt wurden, wenn die serverseitige umgekehrte Geocodierung fehlschlägt.

Release v1.14.2 (2. Februar 2019)

Funktionen

  • Verhindert,dass das DriverSDK 0.0 Standorte an Fleet Engine sendet (bessere Fahrtfreigabe und Eingaben für Zuordnungsort).
  • Zusätzliches Logging, um Probleme mit festhängenden Orten zu beheben und Fallbacks beim Teilen von Routen zu reduzieren.
  • Wiederholte Aufrufe von setLocationReportingInterval() ignorieren, es sei denn, das Intervall ändert sich.
  • Javadocs für die Methode setReportingInterval() wurden aktualisiert, um zu verhindern, dass diese Methode wiederholt mit einer hohen Rate im Verhältnis zu den verwendeten Intervallen aufgerufen wird.
  • Die Standortzuverlässigkeit von API 29 wurde verbessert.

v1.13.0

Stabilität und Fehlerkorrekturen

  • Fügt eine Abhängigkeit von okhttp hinzu, die Clients 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 für die kostenlose Navigation) entspricht dem Farbschema, das für die Navigationsbenachrichtigungen festgelegt wurde. Weitere Informationen finden Sie unter Freigegebene persistente Benachrichtigungen.
  • Ein Problem wurde behoben, bei dem eine verzögerte Standortaktualisierung zu einer falschen Standortaktualisierung führen konnte, die zu Artefakten wie einer geraden Linie am Anfang einer Route führen konnte.

Version 1.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 Netzwerkfehler schnell die Standortaktualisierungen fortsetzt. Sobald die Netzwerkverbindung wiederhergestellt ist, werden die Standortaktualisierungen bei der nächsten geplanten Standortaktualisierung wieder gestartet.

Stabilität und Fehlerkorrekturen

  • setVehicleState() wird jetzt sofort zurückgegeben. Das Aktualisieren von FleetEngine erfolgt jetzt in einem Hintergrundthread. Ein ANR-Problem (Application Not Responding) wurde behoben.
  • Routen wurden bei älteren Versionen des Consumer SDK als gerade Linie angezeigt. Dieses Problem wurde behoben. Sorgt dafür, dass der Route keine einmaligen Wegpunkte vom Driver SDK hinzugefügt werden.