Notas de la versión del SDK de Driver para Android

En esta sección, se incluyen las notas de la versión del SDK de Driver para Android.

v7.99.0 (11 de noviembre de 2026)

Correcciones de errores

• Se solucionó un problema por el que los intentos de conexión segura a Fleet Engine podían permanecer pendientes de forma indefinida si un proxy de operador intermedio se detenía durante la configuración de la conexión, lo que impedía que se actualizaran el estado del viaje y el seguimiento del vehículo en ciertas redes móviles. El SDK de Driver ahora aplica un tiempo de espera de conexión y se recupera automáticamente en una conexión nueva.

• Se corrigieron las filtraciones de subprocesos y ejecutores cuando se llama a DriverApi.clearInstance() (ejecutores FleetEngineEventHandler, FusedLocationWriter y DriverApi).

Cambios en las dependencias y la configuración

• Se actualizaron las dependencias de Jetpack DataStore (androidx.datastore:datastore-core y androidx.datastore:datastore-guava) a la versión 1.2.1.

• Se actualizó la versión de la dependencia de Kotlin a la v2.4.0.

• Se actualizó el rango de versiones compatibles del SDK de Navigation a [7.9.0, 8.0.0).

v7.1.0 (14 de mayo de 2026)

Cambios en las dependencias y la configuración

• Se agregaron dependencias de Jetpack DataStore: androidx.datastore:datastore-core versión 1.1.7 y androidx.datastore:datastore-guava versión 1.2.0.

• Se actualizó la versión de la dependencia de Kotlin a la v2.3.0.

• Se actualizó la versión del complemento de Android para Gradle a la 8.13.2.

• Se actualizó la versión de Gradle a la 8.13.

• Se actualizó la versión de la biblioteca de expansión de sintaxis a la 2.1.5.

• Se expandió el rango de versiones compatibles del SDK de Navigation de [7.0, 7.3) a [7.0, 8.0).

v7.0.0 (5 de diciembre de 2025)

Cambios en las dependencias y la configuración

• Se actualizó minSdkVersion al nivel de API 26.

• Se actualizó targetSdkVersion a la API 36.

• Se actualizaron las versiones de rango compatibles del SDK de Navigation, incluidas las versiones 7.0.0 y posteriores.

v6.99.0 (5 de diciembre de 2025)

• Mejoras internas

Anuncio: Se congelará la compatibilidad con los niveles de API 23, 24 y 25

De acuerdo con la política de compatibilidad con versiones del SO para dispositivos móviles, congelaremos la compatibilidad con Android 6 y 7 (niveles de API 23, 24 y 25) en las próximas versiones principales del SDK de Driver para Android.

A partir de la versión 7.0.0, el SDK de Driver para Android admitirá, como mínimo, Android 8 (nivel de API 26). Las versiones anteriores del SDK seguirán siendo compatibles con Android 6 y 7.

Si tus dependencias no especifican un número de versión, tu IDE cargará la versión más reciente del SDK, y las nuevas compilaciones de tu app no admitirán Android 6 ni 7.

Especifica una versión del SDK de Driver para Android en las dependencias de compilación de tu aplicación para controlar cuándo aumentas el SO mínimo admitido para las versiones nuevas de tu app.

v6.2.0 (18 de junio de 2025)

Correcciones de errores

• Se corrigió la falla de NullPointerException que se producía cuando se llamaba a DriverApi.createInstance() sin proporcionar un DriverStatusListener.

Cambios en las dependencias y la configuración

• A partir de la versión 6.2.0 del SDK de Driver para Android, las apps deben actualizarse a Kotlin 2.1.

• Se actualizaron las versiones de rango compatibles del SDK de Navigation, incluidas las versiones 6.1.0 y posteriores.

v6.1.0 (10 de marzo de 2025)

Correcciones de errores

• Se realizaron mejoras en el registro interno.

v5.99.1 (10 de enero de 2025)

Correcciones de errores

• Se corrigió un problema por el que los conductores recibían errores de gRPC con el código "INTERNAL" y un mensaje "Panic! This is a bug!" en el primer inicio de la aplicación después de la instalación.

v6.0.0 (25 de noviembre de 2024)

Correcciones de errores

• Se solucionó un problema por el que los conductores recibían errores de gRPC con el código "INTERNAL" y un mensaje "Panic! Este es un error".
• Se realizó una mejora interna para reducir los errores de conexión de actualización de ubicación, en especial cuando el dispositivo cambia de red. Se lanzará de forma progresiva (comenzando desde el 0%) una vez que se haya integrado la versión.`

Actualizaciones de API

• Se quitó la interfaz obsoleta StatusListener.

Cambios en las dependencias y la configuración

• Quita la dependencia de glide:cronet-integration en el archivo POM.xml.
• Se actualizaron las versiones de rango compatibles del SDK de Navigation a la versión 5.x.
• A partir de la versión 6.0.0 del SDK de Driver para Android, las apps deben actualizarse a Kotlin 2.0.
• El targetSdk ahora es el nivel de API 34. Este es un requisito para todas las apps que se implementen en Google Play Store a partir de agosto de 2024. Consulta Cómo cumplir con los requisitos de nivel de API objetivo de Google Play.

v5.99.0 (20 de septiembre de 2024)

Correcciones de errores

• Se solucionó un problema por el que los conductores recibían errores de gRPC con el código "INTERNAL" y un mensaje "Panic! Este es un error". Se lanzará de forma progresiva (comenzando desde el 0%) una vez que se haya integrado la versión.
• Se realizó una mejora interna para reducir los errores de conexión de actualización de ubicación, en especial cuando el dispositivo cambia de red. Se lanzará de forma progresiva (comenzando desde el 0%) una vez que se haya integrado la versión.`

Cambios en las dependencias y la configuración

• Quita la dependencia de glide:cronet-integration en el archivo POM.xml.

Versión 5.0.0 (12 de septiembre de 2023)

Cambios en las dependencias y la configuración

• Se actualizó el SDK de Navigation a la versión 5.x.
• Se actualizó minSdkVersion al nivel de API 23.
• Se actualizó la versión de Kotlin a la 1.9.0.
• Se agregó la dependencia de Room. * Las apps que usan el SDK de Driver ahora deben tener un targetSdkVersion de la API 31 o una versión posterior.
• Las apps que usan el SDK de Driver ahora deben habilitar la compatibilidad con la biblioteca de Java 8. Consulta https://developer.android.com/studio/write/java8-support para obtener instrucciones sobre cómo actualizar.
• Las apps que usan Proguard o Dexguard deben migrar a R8. Consulta https://developer.android.com/build/shrink-code para obtener más información.
• Las apps que usan el SDK de Driver deben habilitar la expansión de sintaxis. Consulta https://developer.android.com/studio/write/java8-support#library-desugaring para obtener instrucciones.

Correcciones de errores

• Se corrigió un problema con la sincronización de disableLocationTracking.
• Se introdujo la nueva interfaz DriverStatusListener que informa una causa en las actualizaciones de estado de excepción.
• Se corrigió un problema relacionado con los conductores que permanecían detenidos (disponible a partir de la versión 4.99.0).

v4.99.0 (9 de agosto de 2023)

• Admite un rango de versiones para la dependencia del SDK de Navigation. ** Admite la versión 4.5.0 hasta la versión 5.0.0 (sin incluirla).
• Evita que la hora de llegada estimada disminuya por sí sola cuando el vehículo está detenido. Este cambio se implementará de forma gradual como un experimento, por lo que no todas las aplicaciones lo verán de forma simultánea.

v4.5.0 (12 de mayo de 2023)

• Actualiza la dependencia del SDK de Navigation a la versión 4.5. Ten en cuenta que los IDs de grupo y artefacto del SDK de Navigation cambiaron.

v4.4.3 (20 de marzo de 2023)

Cambio de dependencia

• Se actualizó la dependencia del SDK de Navigation a la versión 4.4.1.

v4.4.2 (15 de febrero de 2023)

Correcciones de errores

• Mejorar el tiempo de recuperación de la red cuando el SDK tiene un problema de conexión temporal Esta es una corrección experimental.

• Descarta las solicitudes de UpdateVehicle que solo contengan una ubicación "sin procesar".

• Se corrigió la condición de carrera en la API de "Resumen de la ruta" en versión ALFA.

v4.4.1 (18 de noviembre de 2022)

Correcciones de errores

• Se corrigió un error en la lógica de carga de tráfico.

Cambios adicionales

• Se realizaron mejoras internas en los encabezados de las solicitudes y los informes de códigos de estado.

v4.4.0 (21 de septiembre de 2022)

Correcciones de errores

• Se corrigió un error que impedía que se quitara la notificación "Conduciendo con Google Maps" si no se borraba la instancia de la API.

Cambio de dependencia

• Se actualizó la dependencia del SDK de Navigation a la versión 4.2.2.

v4.3.0 (24 de agosto de 2022)

Se realizaron mejoras internas.

Anuncio: Se suspenderá la compatibilidad con Android 5 (21 de julio de 2022)

En el caso de nuestra versión más reciente del SDK (v4.2.0), proporcionaremos un año adicional de asistencia para las apps que se ejecutan en Android 5, tanto para los niveles de API 21 como 22.

Qué significa esto:

• El SDK de Navigation y el SDK de Driver que se ejecutan en tus apps para Android admitirán un mínimo de Android 5 (nivel de API 21) hasta el 30 de junio de 2023.
• Después del 30 de junio de 2023, solo admitiremos los niveles de API de Android 23 y posteriores. En otras palabras, dejaremos de admitir los niveles de API 21 y 22 de Android en todas las versiones del SDK después de esa fecha. Esto significa que no se corregirán los errores relacionados con Android 21 o 22 en ninguna versión del SDK (incluida la 4.x) y no garantizamos que los SDKs se comporten correctamente.

Este aviso anula el aviso de congelamiento de la compatibilidad con Android 21 y 22 del 21 de junio de 2021, y el congelamiento de la compatibilidad con Android 23, 24 y 25 del 18 de octubre de 2021.

v4.2.0 (8 de junio de 2022)

Cambio de dependencia

• Actualiza la dependencia del SDK de Navigation a la versión 4.1.3.
• Se cambia el nivel de API de Android mínimo admitido a 21.

v4.1.0 (28 de abril de 2022)

Actualizaciones de API

• Se cambió el nombre de la propiedad parentId del objeto Task a trackingId. La propiedad anterior aún existe, pero ya no se usa.

v4.0.0 (29 de noviembre de 2021)

El nivel de API de Android mínimo admitido para esta versión es el 23.

Actualizaciones de API

En esta versión, el SDK de Driver para Android se actualizó con los siguientes cambios.

Cambio en la API de VehicleStops

Los objetos VehicleStop ahora hacen referencia a una lista de objetos TaskInfo en lugar de una lista de objetos Task. Si necesitas el estado de la tarea, te recomendamos que lo registres en el código de la aplicación.

• Se agregó una clase nueva: TaskInfo

• Se reemplazó la función getTasks de VehicleStop por la función getTaskInfoList.

• Se reemplazó la función setTasks de VehicleStop.Builder por la función setTaskInfoList.

Supervisión de fallas

Se agregaron la supervisión y los informes de fallas para ayudar a mejorar la estabilidad del SDK. Esta función está habilitada de forma predeterminada, pero puedes inhabilitarla si llamas a setAbnormalTerminationReportingEnabled() y le pasas un valor de false antes de inicializar el SDK.

• Se agregó la función setAbnormalTerminationReportingEnabled a DriverApi.

getRemainingVehicleStops asíncrono

• Se cambió la función getRemainingVehicleStops de DeliveryVehicleReporter para que devuelva un Future<List<VehicleStop>> en lugar de un List<VehicleStop>.

Autenticación

Se quitaron las propiedades innecesarias de la interfaz de AuthTokenContext. ServiceType quedó obsoleto. Ahora, solo necesitas obtener reclamaciones para el ID de vehículo y el ID de tarea incluidos, en lugar de depender de ServiceType.

• Se quitó ServiceType de AuthTokenContext.

• Se quitó getServiceType() de AuthTokenContext.

• Se quitó setServiceType de AuthTokenContext.Builder.

18 de octubre de 2021: Se congela la compatibilidad con los niveles de API 23, 24 y 25

v3.0.4 (28 de julio de 2021)

Funciones

Con esta versión, el SDK de Driver se separa oficialmente del SDK de Navigation. Consulta la guía de migración para obtener más detalles.

Actualizaciones de API

Se agregaron los siguientes métodos:

`RidesharingDriverApi.getDriverSdkVersion()`

Mejoras de estabilidad y correcciones de errores

Se informan errores PERMISSION_DENIED en lugar de clasificarlos como errores de conexión.

Anuncio de baja (21 de junio de 2021)

En este anuncio, se describen las bajas del SDK de Driver para Android y del SDK de Navigation para Android a partir de la fecha indicada anteriormente. Este anuncio también se envió como un anuncio obligatorio del servicio (MSA) a los clientes afectados.

El SDK de Navigation/Driver para Android se convertirá en el SDK de Navigation para Android v3.x y el SDK de Driver para Android v3.x para Android (binarios divididos)

Para simplificar la integración de los clientes y acelerar nuestra capacidad de ofrecer funciones útiles, dividiremos el SDK de Navigation para Android y el SDK de Driver para Android en dos objetos binarios diferentes:

• SDK de Navigation para Android, que proporcionará funciones de navegación y enrutamiento para tus conductores
• El SDK de Driver para Android, que te permitirá aprovechar los servicios web con estado de Fleet Engine para el progreso y la asignación de viajes o tareas.

Ten en cuenta que el SDK de Driver para Android tiene una dependencia obligatoria del SDK de Navigation para Android para las funciones de enrutamiento principales.

¿Cuáles son los cambios?

Los cambios principales en la versión 3 son los siguientes:

• Dos objetos binarios en lugar de uno.
• Se definieron paquetes más claros para las clases del SDK de Driver para Android.
• El SDK de Navigation para Android incluye el SDK de Maps para Android como parte del paquete (a partir de la versión 2 del SDK de Navigation para Android).
  • Esto permite que las funciones de mapas y navegación coexistan en el mismo mapa (como dibujar polilíneas en una NavigationView) y reduce el uso de memoria, ya que se usa un solo mapa en lugar de dos.
  • El SDK de Navigation para Android 3.0 no tiene paridad de funciones completa con el SDK de Navigation para Android, pero la versión 3.2 resolverá la mayoría de los problemas aquí. Consulta ¿Qué puedo hacer y cuándo? para obtener más información.
• Registro que nos facilitará la depuración de los problemas que puedas encontrar.

Los siguientes métodos también se quitaron en la versión 3, ya que se habían marcado como obsoletos y ya existe una solución alternativa para ellos:

• Los siguientes métodos del SDK de Navigation/Driver dejaron de estar disponibles en la versión 1.16, lanzada el 10 de agosto de 2020, y se quitaron en la versión 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Para mayor claridad y exhaustividad, ten en cuenta que se quitaron varios métodos en la transición de la versión 1 a la 2. La mayoría de estos cambios fueron consolidaciones de clases duplicadas entre el SDK de Navigation para Android y el SDK de Maps para Android. Consulta la guía de migración para comprender mejor estos cambios.

Baja del SDK de Driver para Android y el SDK de Navigation para Android v1.x

La versión 1 del SDK de Navigation y Driver se lanzó en 2018 y, con el próximo lanzamiento de las versiones 3, es momento de dar de baja la versión 1 para evitar la insostenibilidad de admitir muchas versiones principales.

El tiempo que se ahorra al no tener que admitir esta versión adicional nos permitirá brindar una mejor asistencia para la versión principal más reciente y compilar más funciones que sean importantes para nuestros clientes.

Por lo tanto, el SDK de Navigation/Driver v1.x ahora está obsoleto y dejará de recibir mantenimiento después del 21 de junio de 2022.

Tómate un momento para ver cómo funcionan las bajas en las versiones del SDK.

Fin de la compatibilidad con los SDK de Navigation y Driver para Android 21 y 22

v1.15.3 (9 de octubre de 2020)

Actualizaciones de API

• El SDK de Driver ahora se suscribe al SDK de Navigation para recibir actualizaciones de tráfico, que se envían a la API de Fleet Engine.

Mejoras de estabilidad y correcciones de errores

• Se corrigió una falla del entorno de ejecución de gRPC.

v1.15.2

Funciones

Se agregó la capacidad de detener las notificaciones persistentes. Si se detienen los informes de ubicación en la instancia de Fleet Engine, se detiene la guía en Navigator, se cancela el registro de todos los objetos de escucha de navegación y se pausa NavigationFragment o NavigationView.

Mejoras de estabilidad y correcciones de errores

• Se corrigió un error que causaba que se arrojara una excepción si se borraba la instancia de Fleet Engine.

v1.15.1 (12 de mayo de 2020)

Funciones

El análisis preliminar de los datos de la versión 1.15.0 indicó mejoras significativas en los informes de ubicación estables (reducción de las ubicaciones "bloqueadas"). Esta corrección de parche permite que continúen los informes de ubicación mejorados. El problema de ANR no estaba relacionado con estas mejoras.

Mejoras de estabilidad y correcciones de errores

• Se corrigió un error que, a veces, causaba que se mostrara una línea recta al principio de la ruta en la aplicación para consumidores.
• Se corrigió un error que podía provocar un ANR cuando el SDK informaba las ubicaciones. Esto se debió a las mejoras de onArrival() que eran susceptibles a la contención de bloqueos. Pudimos reproducir los errores de ANR de manera confiable en algunas circunstancias y verificar que las correcciones resolvieron el problema. La app de prueba modificada para producir los ANR se ejecutó durante ocho horas sin un ANR después de la corrección.

v1.15.0 (23 de marzo de 2019)

Funciones

• Se introdujo el estado de la guía de navegación en los eventos de inicio, fuera de ruta y llegada para mejorar el seguimiento de la ubicación del vehículo.
• Se agregó la capacidad de seguir obteniendo ubicaciones ajustadas a la ruta independientemente del estado de navegación.
• Se agregó información adicional sobre las ubicaciones ajustadas a la ruta, como la precisión.

Mejoras de estabilidad y correcciones de errores

• Se aumentó la minSdkVersion para navsdk a 19.
• Se corrigió un error que causaba que no se respetaran los nombres de los puntos de referencia de latitud y longitud cuando fallaba la geocodificación inversa del servidor.

Versión v1.14.2 (2 de febrero de 2019)

Funciones

• Evita que el SDK de Driver envíe ubicaciones 0,0 a Fleet Engine (mejor uso compartido de viajes y entradas de ubicación de asignación).
• Se agregaron registros adicionales para mejorar los problemas de ubicación bloqueada y reducir los resguardos para el uso compartido de viajes.
• Ignora las llamadas repetidas a setLocationReportingInterval(), a menos que cambie el intervalo.
• Se actualizaron los javadocs del método setReportingInterval() con el objetivo de desalentar las llamadas repetidas a este método con una tasa alta en relación con los intervalos que se usan.
• Se mejoró la confiabilidad de la ubicación de la API 29.

v1.13.0

Mejoras de estabilidad y correcciones de errores

• Agrega una dependencia en okhttp que los clientes deberán agregar a sus compilaciones de Gradle.

v1.11.7 (18 de octubre de 2019)

Mejoras de estabilidad y correcciones de errores

• Las actualizaciones de ubicación ahora continúan después de que se activa onArrival() para un destino determinado.
• La notificación predeterminada (una cadena constante en el modo de navegación libre) coincide con el esquema de colores establecido para las notificaciones de navegación. Para obtener más información, consulta Notificaciones persistentes compartidas.
• Se solucionó un problema por el que un evento de actualización de ubicación retrasado podía causar una actualización de ubicación falsa, lo que generaba artefactos como una línea recta al principio de una ruta.

v1.11.6 (4 de octubre de 2019)

Actualizaciones de API

• Se introdujo una serie de cambios que garantizan que el SDK de Driver reanude las actualizaciones de ubicación rápidamente después de una falla de red. Una vez que se restablece la conexión de red, las actualizaciones de ubicación se reanudan en la próxima actualización de ubicación programada.

Mejoras de estabilidad y correcciones de errores

• setVehicleState() ahora se muestra de inmediato. La actualización de FleetEngine ahora se realiza en un subproceso en segundo plano. Se solucionó un problema de error de aplicación no responde (ANR).
• Se corrigió un problema que causaba que las rutas de uso compartido de viajes se mostraran como una línea recta cuando se usaban versiones anteriores del SDK para consumidores. Garantiza que el SDK de Driver no agregue puntos de referencia únicos a la ruta.