Note di rilascio dell'SDK Driver per Android

Questa sezione contiene le note di rilascio dell'SDK Driver per Android.

v7.99.0 (11 novembre 2026)

Correzioni di bug

• Risolto un problema per cui i tentativi di connessione sicura a Fleet Engine potevano rimanere in attesa a tempo indeterminato se un proxy dell'operatore intermedio si bloccava durante la configurazione della connessione, impedendo l'aggiornamento dello stato della corsa e del monitoraggio del veicolo su alcune reti mobili. L'SDK Driver ora applica un timeout della connessione e si ripristina automaticamente su una nuova connessione.

• Sono stati corretti i leak di thread ed esecutori durante la chiamata di DriverApi.clearInstance() (esecutori FleetEngineEventHandler, FusedLocationWriter e DriverApi).

Modifiche alle dipendenze e alla configurazione

• Eseguito l'upgrade delle dipendenze di Jetpack DataStore (androidx.datastore:datastore-core e androidx.datastore:datastore-guava) alla versione 1.2.1.

• È stato eseguito l'upgrade della versione della dipendenza Kotlin alla versione 2.4.0.

• È stato aggiornato l'intervallo di versioni supportate dell'SDK Navigation a [7.9.0, 8.0.0).

v7.1.0 (14 maggio 2026)

Modifiche alle dipendenze e alla configurazione

• Sono state aggiunte le dipendenze di Jetpack DataStore: androidx.datastore:datastore-core versione 1.1.7 e androidx.datastore:datastore-guava versione 1.2.0.

• Upgrade della versione della dipendenza Kotlin alla versione 2.3.0.

• Eseguito l'upgrade della versione del plug-in Android per Gradle alla 8.13.2.

• Upgrade della versione di Gradle alla 8.13.

• Eseguito l'upgrade della versione della libreria Desugar alla 2.1.5.

• È stato ampliato l'intervallo di versioni dell'SDK Navigation supportate da [7.0, 7.3) a [7.0, 8.0).

v7.0.0 (5 dicembre 2025)

Modifiche alle dipendenze e alla configurazione

• Upgrade di minSdkVersion all'API 26.

• Upgrade di targetSdkVersion all'API 36.

• Sono state aggiornate le versioni dell'SDK Navigation supportate, incluse quelle a partire dalla versione 7.0.0.

v6.99.0 (5 dicembre 2025)

• Miglioramenti interni

Annuncio: interruzione del supporto per i livelli API 23, 24 e 25

In conformità con le norme di supporto delle versioni del sistema operativo mobile, stiamo bloccando il supporto di Android 6 e 7 (livelli API 23, 24 e 25) nelle prossime versioni principali di Driver SDK for Android.

A partire dalla versione 7.0.0, l'SDK Driver per Android supporterà almeno Android 8 (livello API 26). Le versioni precedenti dell'SDK continueranno a supportare Android 6 e 7.

Se le dipendenze non specificano un numero di versione, l'IDE caricherà la versione più recente dell'SDK e le nuove build della tua app non supporteranno Android 6 e 7.

Specifica una versione dell'SDK Driver per Android nelle dipendenze di build della tua applicazione per controllare quando aumentare la versione minima del sistema operativo supportata per le nuove versioni della tua app.

v6.2.0 (18 giugno 2025)

Correzioni di bug

• Risolto l'arresto anomalo di NullPointerException durante la chiamata di DriverApi.createInstance() quando non viene fornito un DriverStatusListener.

Modifiche alle dipendenze e alla configurazione

• A partire dalla versione 6.2.0 dell'SDK Driver per Android, le app devono eseguire l'upgrade a Kotlin 2.1.

• Sono state aggiornate le versioni dell'SDK Navigation supportate, incluse quelle a partire dalla versione 6.1.0.

v6.1.0 (10 marzo 2025)

Correzioni di bug

• Miglioramenti alla registrazione interna.

v5.99.1 (10 gennaio 2025)

Correzioni di bug

• Risolto il problema per cui i conducenti ricevevano errori gRPC con il codice "INTERNAL" e un messaggio "Panic! This is a bug!" (Questo è un bug!) al primo avvio dell'applicazione dopo l'installazione.

v6.0.0 (25 novembre 2024)

Correzioni di bug

• Risolto il problema per cui i conducenti ricevevano errori gRPC con il codice "INTERNAL" e un messaggio "Panic! This is a bug!".
• Miglioramento interno per ridurre gli errori di connessione per l'aggiornamento della posizione, in particolare quando il dispositivo cambia rete. Questa funzionalità verrà implementata progressivamente (a partire dallo 0%) una volta integrata la release.`

Aggiornamenti dell'API

• Interfaccia deprecata StatusListener rimossa.

Modifiche alle dipendenze e alla configurazione

• Rimuovi la dipendenza da glide:cronet-integration nel file POM.xml
• Aggiornamento delle versioni supportate dell'SDK Navigation alla versione 5.x.
• A partire dalla versione 6.0.0 dell'SDK Driver per Android, le app devono eseguire l'upgrade a Kotlin 2.0.
• Il targetSdk ora è il livello API 34. Questo è un requisito per tutte le app di cui viene eseguito il deployment sul Google Play Store a partire da agosto 2024. Consulta l'articolo Soddisfa i requisiti relativi ai livelli API target di Google Play.

v5.99.0 (20 settembre 2024)

Correzioni di bug

• Risolto il problema per cui i conducenti ricevevano errori gRPC con il codice "INTERNAL" e un messaggio "Panic! This is a bug!". L'implementazione avverrà progressivamente (a partire dallo 0%) una volta integrata la release.
• Miglioramento interno per ridurre gli errori di connessione per l'aggiornamento della posizione, in particolare quando il dispositivo cambia rete. Questa funzionalità verrà implementata progressivamente (a partire dallo 0%) una volta integrata la release.`

Modifiche alle dipendenze e alla configurazione

• Rimuovi la dipendenza da glide:cronet-integration nel file POM.xml

v5.0.0 (12 settembre 2023)

Modifiche alle dipendenze e alla configurazione

• Aggiornamento dell'SDK Navigation alla versione 5.x.
• Upgrade di minSdkVersion all'API 23.
• Upgrade della versione di Kotlin alla 1.9.0.
• Aggiunta la dipendenza da Room. * Le app che utilizzano l'SDK Driver ora devono avere targetSdkVersion dell'API 31 o versioni successive.
• Le app che utilizzano l'SDK Driver ora devono attivare il supporto della libreria Java 8. Per istruzioni sull'aggiornamento, consulta https://developer.android.com/studio/write/java8-support.
• Le app che utilizzano Proguard o Dexguard devono eseguire la migrazione a R8. Per saperne di più, consulta https://developer.android.com/build/shrink-code.
• Le app che utilizzano l'SDK Driver devono attivare il desugaring. Per istruzioni, consulta https://developer.android.com/studio/write/java8-support#library-desugaring.

Correzioni di bug

• Risolto il problema relativo alla sincronizzazione di disableLocationTracking.
• È stata introdotta la nuova interfaccia DriverStatusListener che segnala una causa negli aggiornamenti dello stato delle eccezioni.
• Risolto il problema relativo ai conducenti che rimangono fermi (disponibile a partire dalla versione 4.99.0).

v4.99.0 (9 agosto 2023)

• Supporta una serie di versioni per la dipendenza NavSDK. ** Supporta dalla versione 4.5.0 alla versione 5.0.0 (esclusa).
• Impedire 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 la vedranno contemporaneamente.

v4.5.0 (12 maggio 2023)

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

v4.4.3 (20 marzo 2023)

Modifica della dipendenza

• Esegui l'upgrade della dipendenza dell'SDK Navigation alla versione 4.4.1.

v4.4.2 (15 febbraio 2023)

Correzioni di bug

• Migliorare il tempo di ripristino della rete quando l'SDK rileva un problema di connessione temporaneo. Si tratta di una correzione sperimentale.

• Ignora le richieste UpdateVehicle che contengono solo una località "Non elaborata".

• Risolto un problema di race condition nell'API ALPHA "Panoramica del percorso".

v4.4.1 (18 novembre 2022)

Correzioni di bug

• Risolto un bug nella logica di caricamento del traffico.

Ulteriori modifiche

• Miglioramenti interni ai report sulle intestazioni delle richieste e sui codici di stato.

v4.4.0 (21 settembre 2022)

Correzioni di bug

• Risolto un bug che impediva la rimozione della notifica "Guida con Google Maps" se l'istanza dell'API non veniva cancellata.

Modifica della dipendenza

• Esegui l'upgrade della dipendenza dell'SDK Navigation alla versione 4.2.2.

v4.3.0 (24 agosto 2022)

Miglioramenti interni.

Annuncio: interruzione del supporto per Android 5 (21 luglio 2022)

Per la nostra ultima versione dell'SDK (v4.2.0), offriamo un anno aggiuntivo di supporto per le app eseguite su Android 5, sia per il livello API 21 che per il livello API 22.

Implicazioni:

• L'SDK di navigazione e l'SDK Driver in esecuzione sulle tue app per Android supporteranno un livello API Android 5 (livello API 21) minimo fino al 30 giugno 2023.
• Dopo il 30 giugno 2023, supporteremo solo i livelli API Android 23 e versioni successive. In altre parole, dopo questa data interromperemo il supporto dei livelli API Android 21 e 22 in tutte le versioni dell'SDK. Ciò significa che i bug relativi ad Android 21 o 22 in qualsiasi versione dell'SDK (inclusa la 4.x) non verranno corretti e non garantiamo che gli SDK funzioneranno correttamente.

Questo avviso sostituisce l'avviso di interruzione del supporto di Android 21 e 22 del 21 giugno 2021 e l'avviso di interruzione del supporto di Android 23, 24 e 25 del 18 ottobre 2021.

v4.2.0 (8 giugno 2022)

Modifica della dipendenza

• Esegui l'upgrade della dipendenza dell'SDK di navigazione alla versione 4.1.3.
• Esegue il downgrade del livello API Android minimo supportato alla versione 21.

v4.1.0 (28 aprile 2022)

Aggiornamenti dell'API

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

v4.0.0 (29 novembre 2021)

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

Aggiornamenti dell'API

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

Modifica all'API VehicleStops

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

• È stata aggiunta una nuova classe: TaskInfo

• La funzione getTasks di VehicleStop è stata sostituita con la funzione getTaskInfoList.

• La funzione setTasks di VehicleStop.Builder è stata sostituita con la funzione setTaskInfoList.

Monitoraggio degli arresti anomali

È stato aggiunto il monitoraggio e la generazione di report sugli arresti anomali per contribuire a migliorare la stabilità dell'SDK. Questa funzionalità è attiva per impostazione predefinita, ma puoi disattivarla se chiami setAbnormalTerminationReportingEnabled() e passi un valore di false prima di inizializzare l'SDK.

• Aggiunta la funzione setAbnormalTerminationReportingEnabled a DriverApi.

Async getRemainingVehicleStops

• Modificata la funzione getRemainingVehicleStops di DeliveryVehicleReporter per restituire un Future<List<VehicleStop>> anziché un List<VehicleStop>.

Autenticazione

Sono state rimosse le proprietà non necessarie dall'interfaccia AuthTokenContext. ServiceType è stato ritirato. Ora devi solo ottenere i claim per l'ID veicolo e l'ID attività inclusi, anziché fare affidamento su ServiceType.

• ServiceType rimosso da AuthTokenContext.

• getServiceType() rimosso da AuthTokenContext.

• setServiceType rimosso da AuthTokenContext.Builder.

18 ottobre 2021: interruzione del supporto per i livelli API 23, 24 e 25

v3.0.4 (28 luglio 2021)

Funzionalità

Con questa release, l'SDK Driver è ufficialmente separato dall'SDK Navigation. Consulta la guida alla migrazione per ulteriori dettagli.

Aggiornamenti dell'API

Sono stati aggiunti i seguenti metodi:

`RidesharingDriverApi.getDriverSdkVersion()`

Stabilità e correzioni di bug

Segnala gli errori PERMISSION_DENIED anziché classificarli come errori di connessione.

Annuncio di ritiro (21 giugno 2021)

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

L'SDK Nav/Driver per Android diventerà l'SDK Navigation per Android v3.x e l'SDK Driver per Android v3.x per Android (file binari suddivisi)

Per semplificare l'integrazione dei clienti e accelerare la nostra capacità di fornire funzionalità utili, stiamo suddividendo l'SDK Navigation per Android e l'SDK Driver per Android in due file binari diversi:

• SDK Navigation per Android, che fornirà funzionalità di navigazione/routing per i tuoi conducenti.
• SDK Driver per Android, che ti consentirà di sfruttare i servizi web stateful di Fleet Engine per l'avanzamento e l'allocazione di corse o attività.

Tieni presente che l'SDK Driver per Android ha una dipendenza obbligatoria dall'SDK Navigation per Android per le funzioni di routing di base.

Quali sono le modifiche?

Le modifiche principali della versione 3 sono:

• Due file binari anziché uno.
• Definizioni dei pacchetti più chiare per le classi dell'SDK Driver per Android.
• Maps SDK for Android è incluso nel pacchetto di Navigation SDK for Android (a partire dalla versione 2 di Navigation SDK for Android).
  • In questo modo, le funzionalità di mappe e navigazione possono coesistere sulla stessa mappa (ad esempio, disegnando polilinee su una NavigationView) e l'utilizzo della memoria viene ridotto, poiché viene utilizzata una sola mappa anziché due.
  • L'SDK Navigation per Android 3.0 non ha la parità di funzionalità completa con l'SDK Navigation per Android, ma la versione 3.2 risolverà la maggior parte dei problemi. Per maggiori dettagli, consulta Cosa posso fare e quando?
• Logging che ci aiuterà a eseguire il debug dei problemi che potresti riscontrare.

Anche i seguenti metodi sono stati rimossi nella versione 3, dopo essere stati contrassegnati come deprecati e per i quali esiste già una soluzione alternativa:

• I seguenti metodi dell'SDK Nav/Driver sono stati ritirati nella versione 1.16, rilasciata il 10 agosto 2020, e sono stati rimossi nella versione 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Per completezza e chiarezza, tieni presente che diversi metodi sono stati rimossi nella transizione dalla versione 1 alla versione 2. La maggior parte di queste modifiche riguardava il consolidamento di classi duplicate tra l'SDK Navigation per Android e Maps SDK for Android. Per comprendere meglio queste modifiche, consulta la guida alla migrazione.

Ritiro dell'SDK Driver per Android e dell'SDK Navigation per Android v1.x

La versione 1 dell'SDK Nav/Driver è stata rilasciata nel 2018 e, con l'imminente rilascio delle versioni 3, è giunto il momento di ritirare la versione 1 per evitare l'insostenibilità del supporto di molte versioni principali.

Il tempo risparmiato non dovendo supportare questa versione aggiuntiva ci consentirà di supportare meglio l'ultima versione principale e di creare più funzionalità importanti per i nostri clienti.

Pertanto, l'SDK Nav/Driver v1.x è ora deprecato e non verrà più gestito dopo il 21 giugno 2022.

Ti invitiamo a dedicare qualche istante per scoprire come funzionano le deprecazioni nelle versioni degli SDK.

Fine del supporto di Android 21 e 22 per l'SDK Navigation e l'SDK Driver

v1.15.3 (9 ottobre 2020)

Aggiornamenti dell'API

• L'SDK Driver ora si iscrive all'SDK Navigation per gli aggiornamenti sul traffico, che vengono inviati all'API Fleet Engine.

Stabilità e correzioni di bug

• Risolto un arresto anomalo del runtime gRPC.

v1.15.2

Funzionalità

Aggiunta la possibilità di interrompere la notifica persistente. Se la segnalazione della posizione viene interrotta nell'istanza di Fleet Engine, le indicazioni vengono interrotte in Navigator, tutti i listener di navigazione vengono annullati e NavigationFragment o NavigationView viene messo in pausa.

Stabilità e correzioni di bug

• Risolto un bug che causava la generazione di un'eccezione se l'istanza di Fleet Engine veniva cancellata.

v1.15.1 (12 maggio 2020)

Funzionalità

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

Stabilità e correzioni di bug

• Risolto un bug che a volte causava la visualizzazione di una linea retta all'inizio del percorso nell'app per utenti finali.
• Risolto un bug che poteva causare un errore ANR durante la segnalazione delle posizioni da parte dell'SDK. Ciò è dovuto ai miglioramenti di onArrival() che erano soggetti a conflitti di blocco. Siamo riusciti a riprodurre gli ANR in modo affidabile in alcune circostanze e abbiamo potuto verificare che le correzioni hanno risolto il problema. L'app di test modificata per generare gli ANR è stata eseguita per otto ore senza un ANR dopo la correzione.

v1.15.0 (23 marzo 2019)

Funzionalità

• È stato introdotto lo stato delle indicazioni stradali per gli eventi di partenza, fuori percorso e arrivo per migliorare il monitoraggio della posizione del veicolo.
• Aggiunta la possibilità di continuare a ricevere posizioni agganciate alla strada indipendentemente dallo stato di navigazione.
• Sono state aggiunte informazioni aggiuntive sulle località pre-agganciate alla strada, ad esempio l'accuratezza.

Stabilità e correzioni di bug

• minSdkVersion per navsdk aumentata a 19.
• Risolto un bug che causava la mancata applicazione dei nomi dei waypoint di latitudine/longitudine quando la geocodifica inversa lato server non andava a buon fine.

Release v1.14.2 (2 febbraio 2019)

Funzionalità

• Impedisce al DriverSDK di inviare posizioni 0,0 a Fleet Engine (migliore condivisione del percorso e input di posizione di allocazione).
• Logging aggiuntivo per migliorare i problemi di posizione bloccata e ridurre i fallback per la condivisione del percorso.
• Ignora le chiamate ripetute a setLocationReportingInterval(), a meno che l'intervallo non cambi.
• Aggiornamento dei javadoc per il metodo setReportingInterval() con l'obiettivo di scoraggiare la chiamata ripetuta di questo metodo a una frequenza elevata rispetto agli intervalli utilizzati.
• Affidabilità della posizione API 29 migliorata.

v1.13.0

Stabilità e correzioni di bug

• Aggiunge una dipendenza da okhttp che i client dovranno aggiungere alle loro build Gradle.

v1.11.7 (18 ottobre 2019)

Stabilità e correzioni di bug

• Gli aggiornamenti della posizione ora continuano dopo l'attivazione di onArrival() per una determinata destinazione.
• La notifica predefinita (una stringa costante in modalità Navigazione libera) corrisponde alla combinazione di colori impostata per le notifiche di navigazione. Per ulteriori informazioni, consulta Notifiche persistenti condivise.
• Risolto un problema per cui un evento di aggiornamento della posizione ritardato poteva causare un aggiornamento della posizione errato, generando artefatti come una linea retta all'inizio di un percorso.

v1.11.6 (4 ottobre 2019)

Aggiornamenti dell'API

• È stata introdotta una serie di modifiche che garantiscono che l'SDK Driver riprenda rapidamente gli aggiornamenti della posizione dopo un errore di rete. Una volta ripristinata la connessione di rete, gli aggiornamenti della posizione riprendono al successivo aggiornamento della posizione programmato.

Stabilità e correzioni di bug

• setVehicleState() ora restituisce immediatamente. L'aggiornamento di FleetEngine ora avviene su un thread in background. Risolve un problema di tipo L'applicazione non risponde (ANR).
• È stato risolto un problema per cui i percorsi di condivisione del percorso venivano visualizzati come una linea retta utilizzando versioni precedenti dell'SDK Consumer. Assicura che l'SDK Driver non aggiunga waypoint una tantum al percorso.