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.1.0 (14 de mayo de 2026)

Cambios en las dependencias y la configuración

• Se agregaron las 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 la configuración y las dependencias

• Se actualizó minSdkVersion a la API 26.

• Se actualizó targetSdkVersion a la API 36.

• Se actualizaron las versiones compatibles del SDK de Navigation, incluida la versión 7.0.0 y versiones 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 conformidad con la Política de compatibilidad con versiones de 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á un mínimo de 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 compilaciones nuevas de tu app no admitirán Android 6 y 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 la configuración y las dependencias

• 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 compatibles del SDK de Navigation, incluida la versión 6.1.0 y versiones 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 de "Panic! Esta es una descripción de "¡Esto es un error!" 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 corrigió un problema por el que los conductores recibían errores de gRPC con el código "INTERNAL" y un mensaje de "Panic! Descripción "Este es un error".
• Se realizó una mejora interna para reducir los errores de conexión de ubicación actualizada, en especial cuando el dispositivo cambia de red. Esta función se lanzará de forma progresiva (a partir del 0%) una vez que se haya integrado la versión.

Actualizaciones de API

• Se quitó la interfaz obsoleta StatusListener.

Cambios en la configuración y las dependencias

• Quita la dependencia de glide:cronet-integration en el archivo POM.xml
• Se actualizaron las versiones 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 corrigió un problema por el que los conductores recibían errores de gRPC con el código "INTERNAL" y un mensaje de "Panic! Descripción "Este es un error". Esta función se lanzará de forma progresiva (a partir del 0%) una vez que se integre la versión.
• Se realizó una mejora interna para reducir los errores de conexión de ubicación actualizada, especialmente cuando el dispositivo cambia de red. Esta función se lanzará de forma progresiva (a partir del 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

v5.0.0 (12 de septiembre de 2023)

Cambios en la configuración y las dependencias

• Se actualizó el SDK de Navigation a la versión 5.x.
• Se actualizó minSdkVersion a la API 23.
• Se actualizó la versión de Kotlin a la 1.9.0.
• Se agregó una dependencia en Room. * Las apps que usan el SDK de Driver ahora deben tener 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 realizar la actualización.
• 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ó el problema por el que los conductores 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 de NavSDK. ** Es compatible con 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)

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

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

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

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

• Se corrigió una condición de carrera en la API ALPHA de "Descripción general de la ruta".

v4.4.1 (18 de noviembre de 2022)

Correcciones de errores

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

Cambios adicionales

• Se realizaron mejoras internas en los encabezados de solicitud y en 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 suspende la compatibilidad con Android 5 (21 de julio de 2022)

En nuestra versión más reciente del SDK (v4.2.0), proporcionamos un año adicional de compatibilidad 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, como mínimo, 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 versiones posteriores. En otras palabras, después de esa fecha, dejaremos de admitir los niveles de API 21 y 22 de Android en todas las versiones del SDK. 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 congelación de la compatibilidad con Android 21 y 22 del 21 de junio de 2021, y la congelación 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 disminuyó 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 todavía existe por el momento, pero dejó de estar disponible.

v4.0.0 (29 de noviembre de 2021)

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

Actualizaciones de API

En esta versión, se actualizó el SDK de Driver para Android 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 realices un seguimiento en el código de tu 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 agregó la supervisión y la generación de 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.

Async getRemainingVehicleStops

• 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 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()`

Corrección de errores y mejoras de estabilidad

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 mencionada anteriormente. Este anuncio también se envió como un anuncio de servicio obligatorio (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 del cliente y acelerar nuestra capacidad de ofrecer funciones útiles, dividiremos el SDK de Navigation para Android y el SDK de Driver para Android en dos archivos 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 en el SDK de Navigation para Android para las funciones de rutas principales.

¿Cuáles son los cambios?

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

• Dos archivos binarios en lugar de uno.
• Se definieron de forma más clara los paquetes 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 detalles.
• 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 previamente como obsoletos y ya existe una solución alternativa:

• 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 Nav/Driver se lanzó en 2018, y, con el próximo lanzamiento de nuestras versiones 3, es hora de dejar de usar la versión 1 para evitar la insostenibilidad de admitir muchas versiones principales.

El tiempo que ahorraremos al no tener que admitir esta versión adicional nos permitirá brindar una mejor asistencia para la versión principal más reciente y crear más funciones que son 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 del Driver ahora se suscribe al SDK de Navigation para recibir actualizaciones de tráfico, que se envían a la API de Fleet Engine.

Corrección de errores y mejoras de estabilidad

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

v1.15.2

Funciones

Se agregó la capacidad de detener la notificación persistente. Si se detiene el registro de ubicación en la instancia de Fleet Engine, se detendrá la guía en Navigator, se anulará el registro de todos los objetos de escucha de navegación y se pausará NavigationFragment o NavigationView.

Corrección de errores y mejoras de estabilidad

• Se corrigió un error que provocaba que se arroje 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 la generación de informes de ubicación estable (reducción de las ubicaciones “atascadas”). 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.

Corrección de errores y mejoras de estabilidad

• Se corrigió un error que, a veces, provocaba 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 ubicaciones. Esto se debió a las mejoras en onArrival() que eran susceptibles a la contención de bloqueos. Pudimos reproducir los errores de ANR de forma confiable en algunas circunstancias y verificar que las correcciones solucionaron el problema. La app de prueba modificada para producir los errores de ANR se ejecutó durante ocho horas sin un error de 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 previas al ajuste a la ruta, como la precisión.

Corrección de errores y mejoras de estabilidad

• Se aumentó el valor de 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 1.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 del recorrido y entradas de ubicación de asignación).
• Se agregó un registro adicional para mejorar los problemas de ubicación atascada y reducir las reversiones para compartir viajes.
• Ignora las llamadas repetidas a setLocationReportingInterval(), a menos que cambie el intervalo.
• Se actualizaron los Javadoc del método setReportingInterval() con el objetivo de desalentar las llamadas repetidas a este método a una velocidad alta en relación con los intervalos que se utilizan.
• Se mejoró la confiabilidad de la ubicación de la API 29.

v1.13.0

Corrección de errores y mejoras de estabilidad

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

v1.11.7 (18 de octubre de 2019)

Corrección de errores y mejoras de estabilidad

• 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 corrigió un problema en el que un evento de ubicación actualizada retrasado podía provocar una actualización de ubicación espuria, lo que generaba artefactos, como una línea recta al comienzo 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 en la red. Una vez que se restablece la conexión de red, las ubicaciones actualizadas se reanudan en la próxima ubicación actualizada programada.

Corrección de errores y mejoras de estabilidad

• 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 ANR (Aplicación no responde).
• Se corrigió un problema que causaba que las rutas de uso compartido del recorrido se mostraran como una línea recta en las versiones anteriores del SDK de consumidor. Garantiza que el SDK del conductor no agregue paradas únicas a la ruta.