Dieser Abschnitt enthält Versionshinweise für das Driver SDK für Android.
Version 4.4.2 (15. Februar 2023)
Fehlerkorrekturen
Verbessern Sie die Netzwerkwiederherstellung, wenn das SDK ein vorübergehendes Verbindungsproblem feststellt. Diese Funktion befindet sich derzeit noch in der Testphase.
Verwerfen Sie
UpdateVehicle
-Anfragen, die nur einen „rohen“ Standort enthalten.Korrigiere die Race-Bedingung in der ALPHA API „Route Overview“.
Version 4.4.1 (18. November 2022)
Fehlerkorrekturen
- Ein Fehler in der Uploadlogik wurde behoben.
Weitere Änderungen
- Interne Verbesserungen der Anfrageheader und der Berichterstellung zu Statuscodes.
Version 4.4.0 (21. September 2022)
Fehlerkorrekturen
- Ein Fehler wurde behoben, der verhinderte, dass die Benachrichtigung „Autofahren mit Google Maps“ entfernt wurde, wenn die API-Instanz nicht gelöscht wurde.
Abhängigkeitsänderung
- Upgrade des Navigation SDK auf Version 4.2.2.
Version 4.3.0 (24. August 2022)
Interne Verbesserungen.
Ankündigung: Support für Android 5 wird eingestellt (21. Juli 2022)
Für unsere neueste SDK-Version (Version 4.2.0) bieten wir für API-Level 21 und 22 ein weiteres Jahr Support für Apps, die unter Android 5 ausgeführt werden.
Was das bedeutet:
- Das in deinen Android-Apps ausgeführte Navigation SDK und das Driver SDK unterstützen bis zum 30. Juni 2023 mindestens Android 5 (API-Level 21).
- Nach dem 30. Juni 2023 unterstützen wir nur noch die Android API-Level 23 und höher. Nach diesem Datum werden wir die Android API-Level 21 und 22 in allen SDK-Versionen einstellen. Das bedeutet, dass Programmfehler im Zusammenhang mit Android 21 oder 22 in jeder SDK-Version (einschließlich 4.x) nicht behoben werden. Wir können auch nicht garantieren, dass sich die SDKs ordnungsgemäß verhalten.
Diese Mitteilung überschreibt die Mitteilung zur Unterstützung von Android 21 und 22 vom 21. Juni 2021 und die Unterstützung von Android 23, 24 und 25 vom 18. Oktober 2021.
Version 4.2.0 (8. Juni 2022)
Abhängigkeitsänderung
- Aktualisieren Sie die Nav SDK-Abhängigkeit auf Version 4.1.3.
- Führt ein Downgrade des mindestens unterstützten Android-API-Levels auf 21 durch.
Version 4.1.0 (28. April 2022)
API-Updates
Die Eigenschaft
parentId
desTask
-Objekts wurde intrackingId
umbenannt. Das alte Attribut ist vorerst noch vorhanden, wurde jedoch eingestellt.Einige Rückgabetypen wurden von
Future
in die spezifischereListenableFuture
und vonList
in die spezifischereImmutableList
geändert.
Version 4.0.0 (29. November 2021)
Der mindestens unterstützte Android-API-Level für diesen Release ist 23.
API-Updates
In dieser Version wurde das Driver SDK für Android mit den folgenden Änderungen aktualisiert.
VehicleStop API-Änderung
VehicleStop
-Objekte verweisen jetzt auf eine Liste von TaskInfo
-Objekten anstelle einer Liste von Task
-Objekten. Wenn Sie den Aufgabenstatus benötigen, sollten Sie dies im Anwendungscode verfolgen.
Neuer Kurs hinzugefügt:
TaskInfo
Die Funktion
getTasks
vonVehicleStop
wurde durch die FunktiongetTaskInfoList
ersetzt.Die Funktion
setTasks
vonVehicleStop.Builder
wurde durch die FunktionsetTaskInfoList
ersetzt.
Absturzüberwachung
Absturzüberwachung und -berichte wurden hinzugefügt, um die Stabilität des SDKs zu verbessern.
Diese Funktion ist standardmäßig aktiviert. Sie können sie jedoch deaktivieren, wenn Sie setAbnormalTerminationReportingEnabled()
aufrufen und ihr den Wert false
übergeben, bevor Sie das SDK initialisieren.
- Die Funktion
setAbnormalTerminationReportingEnabled
wurde zuDriverApi
hinzugefügt.
Asynchrone getVerbleibendeFahrzeugstopps
getRemainingVehicleStops
-Funktion vonDeliveryVehicleReporter
wurde geändert, um Future<List<VehicleStop>> anstelle von List<VehicleStop> zurückzugeben.
Authentifizierung
Nicht benötigte Attribute wurden aus 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.
ServiceType
wurde ausAuthTokenContext
entfernt.getServiceType()
wurde ausAuthTokenContext
entfernt.setServiceType
wurde ausAuthTokenContext.Builder
entfernt.
18. Oktober 2021 – Unterstützung von API-Level 23, 24 und 25 wird nicht mehr unterstützt
Mitteilung vom 18. Oktober lesen
Als Reaktion auf Ä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 in neuen Versionen der Navigation und der Treiber-SDKs für Android nicht mehr unterstützt.
Navigations- und Treiber-SDKs für Android-Versionen, die ab dem dritten Quartal 2022 veröffentlicht wurden, unterstützen nur Geräte mit Android API-Level 26 oder höher.
App-Versionen, die mit Version 4.x oder niedriger des Navigation SDK und des 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)
Features
Mit diesem Release ist das Driver SDK offiziell vom Navigation SDK getrennt. Weitere Informationen finden Sie im Migrationsleitfaden.
API-Updates
Folgende Methoden wurden hinzugefügt:
DeliveryDriverApi.getDriverSdkVersion()
Stabilitäts- und Fehlerkorrekturen
Melden Sie PERMISSION_DENIED
-Fehler, anstatt sie als Verbindungsfehler zu klassifizieren.
Einstellungsankündigung (21. Juni 2021)
In dieser Mitteilung wird die Einstellung des Driver SDK for Android und des Navigation SDK for Android zum oben genannten Datum beschrieben. Diese Mitteilung wurde auch als Servicemitteilung an betroffene Kunden gesendet.
Das Nav/Driver SDK for Android wird zum Navigation SDK für Android v3.x und das Driver SDK für Android v3.x für Android (getrennte Binärprogramme)
Um die Kundenintegration zu vereinfachen und die Bereitstellung nützlicher Funktionen zu beschleunigen, teilen wir das Navigation SDK für Android und das Driver SDK für Android in zwei verschiedene Binärprogramme auf:
- Navigation SDK for Android, das Navigations- und Routingfunktionen für Fahrer bietet.
- Driver SDK for Android, mit dem Sie die zustandsorientierten Fleet Engine-Webdienste für Fahrt- oder Aufgabenfortschritte und die Zuweisung nutzen können.
Beachten Sie, dass das Driver SDK für Android für Navigationsfunktionen, die für das Haupt-SDK für Android erforderlich sind, eine Abhängigkeit erfordert.
Welche Änderungen gibt es?
Die wichtigsten Änderungen in v3 sind:
- Zwei Binärprogramme statt einer.
- Klarere Paketdefinitionen für Driver SDK for Android-Klassen.
- Das Navigation SDK for Android enthält das Maps SDK for Android (ab Version 2 des Navigation SDK für Android).
- So können Karten- und Navigationselemente auf derselben Karte gleichzeitig vorhanden sein (z. B. Polylinien in NavigationView zeichnen) und die Speichernutzung wird reduziert, da eine statt zwei Karten verwendet wird.
- Das Navigation SDK for Android 3.0 hat keine vollständige Funktionalität mit dem Navigation SDK for Android, aber in Version 3.2 werden die meisten Probleme hier behoben. Weitere Informationen finden Sie unter Was kann ich wann tun?.
- Protokollierung, die es uns erleichtert, auftretende Probleme zu beheben.
Die folgenden Methoden wurden auch in v3 entfernt, da sie zuvor als verworfen markiert wurden und für die bereits eine alternative Lösung existiert:
- Die folgenden Nav/Driver SDK-Methoden wurden in Version 1.16 eingestellt und am 10. August 2020 veröffentlicht. In Version 3.0 wurden sie entfernt:
Waypoint#fromLatLng(*)
Waypoint#fromPlaceId(*)
Navigator#startGuidance(resumeIntent)
NavigationApi#initForegroundServiceManager(*)
- Aus Gründen der Vollständigkeit und Klarheit wurde bei der Umstellung von v1 auf v2 eine Reihe von Methoden entfernt. Die meisten davon waren duplizierte Klassen zwischen dem Navigation SDK for Android und dem Maps SDK for Android. Weitere Informationen zu diesen Änderungen finden Sie in der Migrationsanleitung.
Treiber-SDK für Android und Navigation SDK für Android v1.x wird eingestellt
Das Nav/Driver SDK v1 wurde 2018 veröffentlicht. Da unsere v3-Versionen bald veröffentlicht werden, wird es Zeit, die v1 einzustellen, um die Unzuverlässigkeit vieler Hauptversionen zu vermeiden.
Durch die Zeitersparnis, dass diese zusätzliche Version nicht unterstützt werden muss, können wir die neueste Hauptversion besser unterstützen und mehr Features entwickeln, die für unsere Kunden wichtig sind.
Daher wurde das Nav/Driver SDK Version 1.x eingestellt und wird nach dem 21. Juni 2022 nicht mehr unterstützt.
Weitere Informationen zur Einstellung von Versionen in SDK-Versionen
Ende des Supports für Navigation und Treiber-SDK für Android 21 und 22
Angekündigte Mitteilung lesen
Version 4.0 des Navigation SDK for Android und das 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). Version 4.0 wird im 4. Quartal 2021 voraussichtlich veröffentlicht. Das bedeutet:
- App-Versionen mit älteren Versionen als v4.x funktionieren weiterhin auf Geräten mit Android 21 und 22. Deine Treiber-Apps, in die unsere aktuellen SDKs integriert sind, 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 Version 4.x (für Q4 2021 ausgerichtet) erstellt wurden und danach nicht mehr auf Geräten mit Android 21 und 22 installiert werden können. Version 4.x wird für Android 2.2 verwendet.
Die Versionen des Navigation SDK for Android v3 und des Driver SDK for Android v3, für die du ein Upgrade durchführen möchtest, werden in der folgenden Tabelle sowie deren Verfügbarkeit erläutert.
Welche Treiberplattformfunktionen nutzen Sie? | Verwenden Sie diese Funktionen? | Die ersten verfügbaren Versionen, auf die Sie ein Upgrade ausführen sollten, sind... | Voraussichtliche Verfügbarkeit (Änderungen vorbehalten) |
Migrationslinks |
---|---|---|---|---|
Nur Navigation (NavSDK-Methoden) |
Nein | NavSDK Version 3.0.1 | Jetzt | Leitfaden |
Ja | NavSDK Version 3.5 (prognostiziert) | Sept. 2021 | ||
Navigation und Fleet Engine-Tracking (NavSDK- und DriverSDK-Methoden) | Nein | Nav SDK v3.0 und Driver SDK v3.0 | Treiber-Version 3.0-Migrationsanleitung verfügbar in Release | |
Ja | NavSDK v3.x und DriverSDK v3.0 |
Wenn Sie die entfernten Methoden weiterhin verwenden möchten, behalten Sie unter Umständen Version 1.x bei, ohne dass nach dem 21. Juni 2022 Support oder Wartung angeboten wird (siehe nächster Abschnitt).
Wir empfehlen die Migration zu v3.x. Das bedeutet:
* Version 1.x wird am 4. Quartal 2021 zuletzt eingeführt. Daher ist v1 ab diesem Zeitpunkt „eingefroren“.
* Dieser letzte Release kann bis zum 21. Juni 2022 sechs Monate lang gepatcht werden. Danach können wir nicht mehr auf Fehler- oder Funktionsanfragen für Version 1.x reagieren.
Lesen Sie sich die folgende Tabelle und die [Migrationsanleitung](/maps/documentation/navigation-sdk-android/v2/migration) durch, um sich mit den Änderungen vertraut zu machen.
Was kann ich bis dahin tun?
Aktuelle Situation... | Verwenden Sie diese Funktionen? | Jetzt umstellen | Upgrade im September 2021 | 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 / Treiberfunktion) |
Nein | Keine Option | NavSDK 3.x + DriverSDK 3.x |
Das oben stehende Handbuch sowie der Treiber v3.0-Migrationsleitfaden sind seit der Veröffentlichung verfügbar. |
Ja |
Wir empfehlen dir, deine Treiber mit Geräten unter Android 21 und 22 zu informieren, um ein Upgrade auf eine neuere Android-Version (mindestens Android 6.0) durchzuführen, bevor du das Treiber-SDK für Android und das Navigation SDK für Android v4.x oder höher in deine Treiber-App einbindest.
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äts- und Fehlerkorrekturen
- Ein Absturz der gRPC-Laufzeit wurde behoben.
Version 1.15.2
Features
Es wurde die Möglichkeit hinzugefügt, die dauerhafte Benachrichtigung zu beenden. Wenn der Standortbericht in der Fleet Engine-Instanz gestoppt wird, wird die Anleitung in Navigator
beendet, alle Navigations-Listener sind abgemeldet und NavigationFragment
oder NavigationView
ist pausiert.
Stabilitäts- und Fehlerkorrekturen
- Ein Fehler wurde behoben, der beim Löschen der Fleet Engine-Instanz eine Ausnahme ausgelöst hat.
Version 1.15.1 (12. Mai 2020)
Features
Die vorläufige Analyse der Daten von 1.15.0 ergab eine deutliche Verbesserung der stabilen Standortberichte (Reduzierung hängender Standorte). Mit dieser Patchkorrektur kann der verbesserte Standortbericht fortgesetzt werden. Das Problem mit dem ANR-Fehler steht in keinem Zusammenhang mit diesen Verbesserungen.
Stabilitäts- und Fehlerkorrekturen
- Ein Fehler wurde behoben, der manchmal dazu führte, dass in der Nutzer-App eine gerade Linie am Anfang der Route angezeigt wurde.
- Ein Fehler wurde behoben, der zu einem ANR-Fehler führen konnte, wenn Standorte vom SDK gemeldet wurden. Dies führte zu
onArrival()
Verbesserungen, die anfällig für Sperren waren. Wir konnten ANRs unter bestimmten Umständen zuverlässig reproduzieren und konnten feststellen, dass das Problem durch die Fehlerbehebungen gelöst wurde. Die modifizierte Testanwendung zum Erstellen der ANRs wurde nach der Fehlerbehebung acht Stunden lang ohne ANR ausgeführt.
Version 1.15.0 (23. März 2019)
Features
- Es wurde ein Navigationsführungsstatus für Start-, Off-Route- und Ankunftsereignisse eingeführt, um die Verfolgung des Fahrzeugstandorts zu verbessern.
- Die Möglichkeit, weiterhin Straßenpositionen zu finden, wurde unabhängig vom Marinezustand hinzugefügt.
- Es wurden zusätzliche Informationen zu vorgelagerten Standorten wie beispielsweise die Genauigkeit hinzugefügt.
Stabilitäts- und Fehlerkorrekturen
- Die minSdkVersion für navsdk wurde auf 19 erhöht.
- Es wurde ein Fehler behoben, der dazu führte, dass lat/lng-Wegpunktnamen nicht berücksichtigt wurden, wenn das serverseitige umgekehrte Geocoding fehlschlägt.
Version 1.14.2 (2. Februar 2019)
Features
- Verhindert, dass das DriverSDK 0,0 Standorte an Fleet Engine sendet (bessere Freigabe und Zuordnung von Standorteingaben).
- Zusätzliches Logging, um Probleme bei hängen gebliebenen Standorten zu reduzieren und Fallbacks bei der Routenfreigabe zu reduzieren
- Ignorieren Sie wiederholte Aufrufe von
setLocationReportingInterval()
, wenn sich das Intervall nicht ändert. - Aktualisierte Javadocs für die Methode
setReportingInterval()
mit dem Ziel, wiederholte Aufrufe dieser Methode mit einer hohen Rate im Verhältnis zu den verwendeten Intervallen zu verhindern. - Standortzuverlässigkeit für API 29 verbessert.
v1.13.0
Stabilitäts- 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äts- 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 ist. Weitere Informationen finden Sie unter Freigegebene Benachrichtigungen.
- Ein Problem wurde behoben, bei dem ein verzögertes Standortaktualisierungsereignis eine falsche Standortaktualisierung verursachte, die Artefakte wie eine gerade Linie am Anfang einer Route verursachte.
Version 1.11.6 (4. Oktober 2019)
API-Updates
- Eine Reihe von Änderungen wurden eingeführt, damit das Driver SDK Standortaktualisierungen nach einem Netzwerkausfall schnell wieder aufnimmt. Sobald die Netzwerkverbindung wiederhergestellt ist, werden die Standortupdates beim nächsten geplanten Standortupdate wieder gestartet.
Stabilitäts- und Fehlerkorrekturen
setVehicleState()
wird jetzt sofort zurückgegeben. Die Aktualisierung von FleetEngine erfolgt jetzt in einem Hintergrundthread. Behebt das Problem mit einer nicht reagierenden Anwendung (ANR).- Es wurde ein Problem behoben, durch das Routen zum Teilen von Routen mit älteren Versionen des Consumer SDK als gerade Linie angezeigt wurden. Damit werden der Route vom Driver SDK keine einmaligen Wegpunkte hinzugefügt.