Note di rilascio dell'SDK Driver per Android

Questa sezione contiene le note di rilascio per l'SDK dei driver per Android.

v5.0.0 (12 settembre 2023)

Modifiche alle dipendenze e alla configurazione

  • SDK di navigazione aggiornato alla versione 5.x.
  • Upgrade di minSdkVersion all'API 23 eseguito.
  • Versione di Kotlin aggiornata alla 1.9.0.
  • Aggiunta una dipendenza per Stanza.
  • Le app che utilizzano l'SDK Driver ora devono avere targetSdkVersion API 31 o versioni successive.
  • Le app che utilizzano l'SDK Driver ora devono abilitare il supporto della libreria Java 8. Vedi https://developer.android.com/studio/write/java8-support per istruzioni sull'aggiornamento.
  • È necessario eseguire la migrazione delle app che utilizzano ProGuard o Dexguard alla versione R8. Per saperne di più, visita la pagina https://developer.android.com/build/shrink-code.
  • Le app che utilizzano l'SDK Driver devono abilitare il desugaring. Per le istruzioni, visita la pagina https://developer.android.com/studio/write/java8-support#library-desugaring.

Correzioni di bug

  • È stato risolto il problema relativo alla disattivazione della sincronizzazione diLocationTracking.
  • È stata introdotta la nuova interfaccia DriverStatusListener che segnala una causa negli aggiornamenti dello stato dell'eccezione.
  • È stato risolto il problema relativo ai driver rimasti inattivi (disponibile a partire dalla versione 4.99.0).

v4.99.0 (9 agosto 2023)

  • Supporta una gamma di versioni per la dipendenza NavSDK. ** Supporta le versioni 4.5.0 e 5.0.0 escluse.
  • Impedisci che l'orario di arrivo stimato diminuisca da solo quando il veicolo è fermo. Questa modifica viene implementata gradualmente come esperimento, pertanto non tutte le applicazioni noteranno la modifica contemporaneamente.

v4.5.0 (12 maggio 2023)

  • Aggiorna la dipendenza SDK di navigazione alla versione 4.5. Tieni presente che gli ID gruppo e artefatto per l'SDK di navigazione sono cambiati.

v4.4.3 (20 marzo 2023)

Modifica delle dipendenze

  • Esegui l'upgrade della dipendenza SDK di navigazione alla versione 4.4.1.

v4.4.2 (15 febbraio 2023)

Correzioni di bug

  • Migliora i tempi di recupero della rete quando l'SDK riscontra un problema di connessione temporaneo. Questa funzionalità è attualmente in fase di implementazione come esperimento.

  • Ignora le richieste di UpdateVehicle contenenti solo un valore "Raw" in ogni località.

  • Correggi la condizione di gara nella "Panoramica del percorso" API ALPHA.

v4.4.1 (18 novembre 2022)

Correzioni di bug

  • È stato corretto un bug nella logica di caricamento del traffico.

Ulteriori modifiche

  • Miglioramenti interni nelle intestazioni delle richieste e nei report sul codice di stato.

v4.4.0 (21 settembre 2022)

Correzioni di bug

  • È stato corretto un bug che impediva la visualizzazione degli elementi "Guidare con Google Maps" la notifica di rimozione se l'istanza API non è stata cancellata.

Modifica delle dipendenze

  • Esegui l'upgrade della dipendenza SDK di navigazione alla versione 4.2.2.

v4.3.0 (24 agosto 2022)

Miglioramenti interni.

Annuncio: blocco del supporto di Android 5 (21 luglio 2022)

Per l'ultima versione dell'SDK (v4.2.0), offrendo un ulteriore anno di assistenza per le app eseguite su Android 5, sia per Livelli API 21 e 22.

Implicazioni:

  • L'SDK di navigazione e l'SDK del driver in esecuzione sulle tue app Android supporteranno un minimo Android 5 (livello API 21) fino al 30 giugno 2023.
  • Dopo il 30 giugno 2023, supporteremo solo i livelli API Android 23 e successivi. In altre parole, non supporteremo più i livelli API 21 e 22 dell'API Android tutte le versioni dell'SDK successive a questa data. Ciò significa che i bug relativi ad Android 21 o 22 in qualsiasi versione dell'SDK (compresa la 4.x) non verranno corrette e non garantire che gli SDK si comportino correttamente.

Questa notifica sostituisce l'avviso di blocco dell'assistenza per Android 21 e 22 di giugno 21, 2021 e Android 23, 24 e 25 supportano il blocco a partire dal 18 ottobre 2021.

v4.2.0 (8 giugno 2022)

Modifica delle dipendenze

  • Esegui l'upgrade della dipendenza dell'SDK Nav alla v4.1.3.
  • Esegue il downgrade a 21 del livello API Android minimo supportato.

v4.1.0 (28 aprile 2022)

Aggiornamenti delle API

  • La proprietà parentId dell'oggetto Task è stata rinominata in trackingId. Il vecchio esiste ancora, ma è deprecata.

v4.0.0 (29 novembre 2021)

Il livello API Android minimo supportato per questa release è 23.

Aggiornamenti delle API

Per questa release, l'SDK Driver per Android è stato aggiornato con le seguenti modifiche.

Modifica all'API VehicleStops

VehicleStop oggetti ora fanno riferimento a un elenco di TaskInfo anziché un elenco di oggetti Task di oggetti strutturati. Se hai bisogno dello stato dell'attività, allora ti invitiamo a monitorarlo nel codice della tua applicazione.

  • È stato aggiunto un nuovo corso: TaskInfo

  • Funzione getTasks di VehicleStop sostituita con la getTaskInfoList: personalizzata.

  • Funzione setTasks di VehicleStop.Builder sostituita con la setTaskInfoList: personalizzata.

Monitoraggio degli arresti anomali

Sono stati aggiunti il monitoraggio degli arresti anomali e il reporting per migliorare la stabilità dell'SDK. Questa funzionalità è attiva per impostazione predefinita, ma puoi disabilitarla se chiami setAbnormalTerminationReportingEnabled() e trasmettigli il valore false prima di inizializzare l'SDK.

Async getAllowed VehicleStops

Autenticazione

Proprietà non necessarie rimosse dall'interfaccia AuthTokenContext. L'API ServiceType è stata deprecata. Ora devi solo ricevere le rivendicazioni per ha incluso l'ID veicolo e l'ID attività, anziché fare affidamento su ServiceType.

18 ottobre 2021: supporto del blocco per le API di livello 23, 24 e 25

Leggi l'annuncio del 18 ottobre

In risposta ai cambiamenti nelle nostre dipendenze interne, l'API Android Livello 23, Le versioni 24 e 25 (Android 6, 7.0 e 7.1) non saranno supportate nelle nuove versioni degli SDK Navigatore e Driver per Android, a partire dalla terza trimestre del 2022.

Gli SDK Navigatore e Driver per le versioni Android rilasciate a partire dalla terza trimestre del 2022 supporterà solo dispositivi che eseguono Livello API Android 26.

Versioni dell'app create con la versione 4.x o precedente degli SDK Navigatore e Driver per Android continuerà a funzionare sui dispositivi che eseguono il Livello 25 dell'API Android e inferiori.

v3.0.4 (28 luglio 2021)

Funzionalità

Con questa release, l'SDK driver è ufficialmente separato dall'SDK di navigazione. Consulta le guida alla migrazione per maggiori dettagli.

Aggiornamenti delle API

Sono stati aggiunti i seguenti metodi:

RidesharingDriverApi.getDriverSdkVersion()

Stabilità e correzioni di bug

Segnala PERMISSION_DENIED errori anziché classificarli come errori di connessione.

Annuncio sul ritiro (21 giugno 2021)

Questo annuncio descrive i ritiri dell'SDK Driver per Android e l'SDK di navigazione per Android alla data indicata sopra. Questo annuncio è stato inviato anche come annuncio di servizio obbligatorio (MSA) ai clienti interessati.

Semplificare l'integrazione dei clienti e accelerare la nostra capacità di fornire informazioni funzionalità, stiamo dividendo l'SDK di navigazione per Android e Driver SDK per Android in due diversi programmi binari:

  • SDK di navigazione per Android, che fornirà la navigazione e il percorso. per i conducenti.
  • Driver SDK per Android, che ti consentirà di sfruttare il parco risorse Motore con servizi web stateful per l'avanzamento e l'assegnazione di viaggi o attività.

Tieni presente che l'SDK Driver per Android ha una dipendenza obbligatoria SDK di navigazione per Android per le funzioni di routing principali.

Quali sono le modifiche?

Le principali modifiche nella versione 3 sono:

  • Due file binari anziché uno.
  • Definizioni dei pacchetti più chiare per le classi dell'SDK Driver per Android.
  • L'SDK di navigazione per Android include l'SDK Maps per Android come parte della confezione (dall'SDK di navigazione per Android v2).
    • In questo modo le mappe e le funzioni di navigazione possono coesistere sulla stessa mappa. (ad esempio disegnando polilinee su una NavigationView) e riduce la memoria utilizzata poiché viene usata una singola mappa al posto di due.
    • L'SDK di navigazione per Android 3.0 non dispone di tutte le funzionalità corrispondenti SDK di navigazione per Android, ma la versione 3.2 consente di risolvere la maggior parte dei problemi qui. Vedi Cosa posso fare e quando? per ulteriori dettagli.
  • Logging che semplificherà il debug dei problemi che potresti riscontrare.

Nella versione v3 sono stati rimossi anche i metodi seguenti perché in precedenza erano contrassegnati come deprecati e per i quali è già disponibile una soluzione alternativa esiste:

  • I seguenti metodi dell'SDK Nav/Driver sono stati deprecati nella versione 1.16, rilasciata il giorno 10 agosto 2020 e rimossi dalla versione 3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Per completezza e chiarezza, tieni presente che sono stati rimossi vari metodi nella transizione da v1 a v2. La maggior parte di questi erano consolidamenti di duplicati tra l'SDK di navigazione per Android e il Maps SDK per Android. Consulta le guida alla migrazione per comprendere meglio questi cambiamenti.

Ritiro dell'SDK Driver for Android e dell'SDK di navigazione per Android v1.x

L'SDK Nav/Driver v1 è stato rilasciato nel 2018 e presto lo sarà con la nostra versione v3 è il momento di ritirare la versione 1 per evitare l'insostenibilità supportando molte versioni principali.

Il tempo risparmiato dal non dover supportare questa versione aggiuntiva consentirà per supportare meglio l'ultima versione principale e creare altre funzionalità che sono importanti per i nostri clienti.

Di conseguenza, la versione 1.x dell'SDK Nav/Driver è deprecata e non verrà più gestita dopo il 21 giugno 2022.

Dedica qualche istante alla visualizzazione come funzionano i ritiri nelle versioni dell'SDK.

Leggi la comunicazione revocata

La prossima versione 4.0 dell'SDK di navigazione per Android e L'SDK Driver per Android supporterà almeno [Android 6.0 (livello API 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. L'attuale versione minima supportata è Android 5.0 (livello API 21). Prevediamo il rilascio della versione 4.0 nel quarto trimestre del 2021. Ciò significa che:

  • Le versioni dell'app create con versioni precedenti alla 4.x continueranno a funzionare su Dispositivi Android 21 e 22. Le tue app per driver che hanno integrato le nostre gli SDK attuali continueranno a funzionare sui dispositivi con Android 21 e versioni successive. È lo stesso di prima.
  • Versioni dell'app create con l'SDK Driver per Android e SDK di navigazione per Android v4.x (target per Q4 2021 (soggetto a modifiche) e in seguito non potranno essere installati su i dispositivi con Android 21 e 22. La versione 4.x funzionerà su almeno Android 6.0 (livello API 23), pertanto le versioni della tua app create con la prossima versione 4.x possono essere ricevute dai conducenti con dispositivi con Android 23 o versioni successive. Per ribadire, ciò significa che sia le modifiche relative all'SDK sia le modifiche apportate alle app non raggiungeranno i driver con dispositivi Android 21 e 22.

Le versioni dell'SDK di navigazione per Android v3 e SDK del driver per Android v3 di cui vuoi eseguire l'upgrade sono spiegati nella tabella seguente insieme alle tempistiche di disponibilità.

Quali funzionalità della piattaforma di driver utilizzi? Utilizzi queste funzionalità? Le prime versioni disponibili a cui dovresti eseguire l'upgrade sono... Disponibilità prevista
(soggetta a variazione)		 Collegamenti migrazione
Solo navigazione
(metodi NavSDK)		 No NavSDK v3.0.1 Ora Guida
Sì NavSDK v3.5 (previsto) settembre 2021
Navigazione e monitoraggio Fleet Engine (metodi NavSDK e DriverSDK) No SDK Nav v3.0 e Driver SDK v3.0 Guida alla migrazione del driver v3.0 disponibile al momento della release
Sì NavSDK v3.x e DriverSDK v3.0

Per continuare a utilizzare i metodi rimossi, puoi rimanere alla versione 1.x, ma senza assistenza o manutenzione prevista dopo il 21 giugno 2022 (vedi la sezione successiva).

Ti consigliamo di eseguire la migrazione alla versione v3.x. Ciò significa che:

* L'ultima release della versione v1.x avverrà il quarto trimestre del 2021 (e quindi la versione v1 è "funzionalità bloccata" da allora).

* Quest'ultima release può essere aggiornata per 6 mesi, fino al 21 giugno 2022. Trascorso questo periodo, non saremo in grado di rispondere a richieste di bug o di funzionalità per v1.x.

Dedica qualche istante a esaminare la seguente tabella e [guida alla migrazione](/maps/documentation/navigation-sdk-android/v2/migration) in per aiutarti a gestire queste modifiche.

Cosa posso fare entro quando?

Se al momento sei su... Utilizzi queste funzionalità? Per eseguire l'upgrade adesso Per eseguire l'upgrade a settembre 2021 Collegamenti migrazione
v1.x
(non utilizza FleetEngine.java / funzionalità Driver) 		No NavSDK v3.0 Guida
Sì Nessuna opzione NavSDK 3.x
v1.x
(con FleetEngine.java / funzionalità Driver)		 No Nessuna opzione NavSDK 3.x +
DriverSDK 3.x		 La guida riportata sopra, più la guida alla migrazione del driver v3.0 disponibile al momento del rilascio.
Sì

Ti consigliamo di inviare una notifica ai conducenti con dispositivi Android 21 e 22 di eseguire l'upgrade a una versione più recente di Android (minimo Android 6.0) prima di integra l'SDK Driver per Android e l'SDK di navigazione per Android versione 4.x e successive nell'app driver.

v1.15.3 (9 ottobre 2020)

Aggiornamenti delle API

  • L'SDK Driver si abbona all'SDK di navigazione per ricevere aggiornamenti sul traffico. che vengono inviate all'API Fleet Engine.

Stabilità e correzioni di bug

  • È stato risolto un arresto anomalo del runtime gRPC.

v1.15.2

Funzionalità

Aggiunta la possibilità di interrompere le notifiche persistenti. Se la segnalazione della posizione viene arrestato nell'istanza Fleet Engine, la guida viene interrotta in Navigator, tutti i listener di navigazione non sono registrati e NavigationFragment o NavigationView è in pausa.

Stabilità e correzioni di bug

  • È stato corretto un bug che causava la generazione di un'eccezione se l'istanza Fleet Engine era stata cancellata.

v1.15.1 (12 maggio 2020)

Funzionalità

L'analisi preliminare dei dati di 1.15.0 ha indicato miglioramenti significativi nella segnalazione della posizione stabile (riduzione delle località "bloccate"). Correzione di questa patch consente di continuare la segnalazione della posizione migliorata. Il problema ANR non era correlato a questi miglioramenti.

Stabilità e correzioni di bug

  • È stato corretto un bug che a volte causava una linea retta all'inizio del percorso da mostrare nell'app per consumatori.
  • È stato corretto un bug che potrebbe causare un errore ANR quando vengono segnalate le posizioni dall'SDK. Questo è il risultato di onArrival() miglioramenti che sono stati suscettibili di contesa del blocco. Siamo riusciti a riprodurre gli ANR in modo affidabile in alcune circostanze ed è stato possibile verificare che le correzioni siano state risolte risolvere il problema. L'app di test modificata per la produzione degli ANR è stata eseguita per otto ore senza un errore ANR dopo la correzione.

v1.15.0 (23 marzo 2019)

Funzionalità

  • Introduzione dello stato delle indicazioni di navigazione per eventi di partenza, deviazione dal percorso e arrivo per migliorare il rilevamento della posizione del veicolo.
  • Aggiunta la possibilità di continuare a ottenere in modo indipendente le località agganciate alla strada dello stato di navigazione.
  • Sono state aggiunte ulteriori informazioni sui luoghi agganciati in precedenza, come la precisione.

Stabilità e correzioni di bug

  • Aumentato il valore di minSdkVersion per navsdk a 19.
  • È stato corretto un bug che causava il mancato rispetto dei nomi dei waypoint lat/lng quando la geocodifica inversa lato server ha esito negativo.

Release v1.14.2 (2 febbraio 2019)

Funzionalità

  • Impedisce a DriverSDK di inviare posizioni 0,0 a Fleet Engine (meglio la condivisione del percorso e gli input relativi alla posizione).
  • Logging aggiuntivo per migliorare i problemi di posizione bloccata e ridurre per condividere il percorso.
  • Ignora le chiamate ripetute a setLocationReportingInterval(), a meno che l'intervallo non cambi.
  • Documenti Java aggiornati per il metodo setReportingInterval() con l'obiettivo di scoraggiare chiamate ripetute di questo metodo con un tasso elevato di agli intervalli utilizzati.
  • Affidabilità della posizione dell'API 29 migliorata.

v1.13.0

Stabilità e correzioni di bug

  • Aggiunge una dipendenza su okhttp che i client dovranno aggiungere alle build di Gradle.

v1.11.7 (18 ottobre 2019)

Stabilità e correzioni di bug

  • Ora gli aggiornamenti della posizione continuano dopo l'attivazione di onArrival() per una una data destinazione.
  • La notifica predefinita (una stringa costante nella modalità di navigazione senza costi) corrisponde alla combinazione di colori impostata per le notifiche di navigazione. Per ulteriori informazioni, vedi Notifiche permanenti condivise.
  • Risolto un problema per cui un evento di aggiornamento della posizione ritardato poteva causare aggiornamento della posizione spurie, con elementi quali una linea retta in corrispondenza l'inizio di un percorso.

v1.11.6 (4 ottobre 2019)

Aggiornamenti delle API

  • È stata introdotta una serie di modifiche per garantire il ripristino dell'SDK del driver la posizione viene aggiornata rapidamente dopo un errore di rete. Una volta che la connessione di rete è stata ripristinata, gli aggiornamenti della posizione verranno riavviati nella prossima posizione pianificata aggiornamento.

Stabilità e correzioni di bug

  • setVehicleState() ora restituisce immediatamente. L'aggiornamento di FleetEngine ora viene eseguito in background . Risolve un problema ANR (L'applicazione non risponde).
  • È stato risolto un problema che causava la visualizzazione dei percorsi per la condivisione dei percorsi utilizzando versioni precedenti dell'SDK consumer. Garantisce che le tappe una tantum vengono aggiunte al percorso dall'SDK Driver.