Notas da versão do SDK do driver para Android

Esta seção contém notas da versão do SDK do Driver para Android.

v7.99.0 (11 de novembro de 2026)

Correções de bugs

  • Correção de um problema em que as tentativas de conexão segura com o Fleet Engine podiam permanecer pendentes indefinidamente se um proxy de operadora intermediário parasse durante a configuração da conexão, impedindo que as atualizações de status da viagem e de rastreamento de veículos fossem atualizadas em determinadas redes móveis. O SDK do Driver agora aplica um tempo limite de conexão e se recupera automaticamente em uma nova conexão.

  • Correção de vazamentos de linha de execução e executor ao chamar DriverApi.clearInstance() (executores FleetEngineEventHandler, FusedLocationWriter e DriverApi).

Mudanças de dependência e configuração

  • As dependências do Jetpack DataStore (androidx.datastore:datastore-core e androidx.datastore:datastore-guava) foram atualizadas para a versão 1.2.1.

  • A versão da dependência do Kotlin foi atualizada para a v2.4.0.

  • Atualizamos o intervalo de versões compatíveis do SDK do Navigation para [7.9.0, 8.0.0).

v7.1.0 (14 de maio de 2026)

Mudanças de dependência e configuração

  • Adicionamos as dependências do Jetpack DataStore: androidx.datastore:datastore-core versão 1.1.7 e androidx.datastore:datastore-guava versão 1.2.0.

  • A versão da dependência do Kotlin foi atualizada para a v2.3.0.

  • A versão do Plug-in do Android para Gradle foi atualizada para 8.13.2.

  • A versão do Gradle foi atualizada para 8.13.

  • A versão da biblioteca de simplificação foi atualizada para 2.1.5.

  • Expandimos o intervalo de versões compatíveis do SDK do Navigation de [7.0, 7.3) para [7.0, 8.0).

v7.0.0 (5 de dezembro de 2025)

Mudanças de dependência e configuração

  • Upgrade de minSdkVersion para a API 26.

  • Upgrade de targetSdkVersion para a API 36.

  • Atualizamos as versões compatíveis do SDK do Navigation, incluindo e a partir da v7.0.0.

v6.99.0 (5 de dezembro de 2025)

  • Melhorias internas

Comunicado: congelamento do suporte para os níveis da API 23, 24 e 25

De acordo com a Política de suporte a versões de SO para dispositivos móveis, vamos congelar o suporte ao Android 6 e 7 (níveis 23, 24 e 25 da API) nas próximas versões principais do SDK do Driver para Android.

A partir da v7.0.0, o SDK do Driver para Android vai oferecer suporte ao Android 8 (nível 26 da API) ou versões mais recentes. As versões anteriores do SDK vão continuar compatíveis com o Android 6 e 7.

Se as dependências não especificarem um número de versão, o ambiente de desenvolvimento integrado vai carregar a versão mais recente do SDK, e os novos builds do app não serão compatíveis com o Android 6 e 7.

Especifique uma versão do SDK do Driver para Android nas dependências de build do aplicativo para controlar quando você aumenta o SO mínimo compatível com as novas versões do app.

v6.2.0 (18 de junho de 2025)

Correções de bugs

  • Correção da falha de NullPointerException ao chamar DriverApi.createInstance() quando um DriverStatusListener não é fornecido.

Mudanças de dependência e configuração

  • A partir da versão 6.2.0 do SDK do Driver para Android, os apps precisam fazer upgrade para o Kotlin 2.1.

  • Atualizamos as versões compatíveis do SDK Navigation, incluindo e a partir da v6.1.0.

v6.1.0 (10 de março de 2025)

Correções de bugs

  • Melhorias na geração de registros internos.

v5.99.1 (10 de janeiro de 2025)

Correções de bugs

  • Correção de um problema em que os motoristas recebiam erros de gRPC com o código "INTERNAL" e uma mensagem "Panic! This is a bug!" na primeira inicialização do aplicativo após a instalação.

v6.0.0 (25 de novembro de 2024)

Correções de bugs

  • Correção do problema em que os drivers recebiam erros de gRPC com o código "INTERNAL" e uma mensagem "Panic! Isso é um bug!".
  • Melhoria interna para reduzir erros de conexão de atualização de local, especialmente quando o dispositivo troca de rede. Isso será lançado progressivamente (começando em 0%) depois que a versão for integrada.`

Atualizações da API

  • A interface descontinuada StatusListener foi removida.

Mudanças de dependência e configuração

  • Remova a dependência de glide:cronet-integration no POM.xml.
  • Atualizamos as versões compatíveis do SDK do Navigation para a v5.x.
  • A partir da versão 6.0.0 do SDK do Driver para Android, os apps precisam fazer upgrade para o Kotlin 2.0.
  • O targetSdk agora é o nível 34 da API. Esse é um requisito para todos os apps implantados na Google Play Store a partir de agosto de 2024. Consulte Atender ao requisito de nível desejado da API do Google Play.

v5.99.0 (20 de setembro de 2024)

Correções de bugs

  • Correção do problema em que os drivers recebiam erros de gRPC com o código "INTERNAL" e uma mensagem "Panic! Isso é um bug!". Isso será lançado progressivamente (começando em 0%) depois que a versão for integrada.
  • Melhoria interna para reduzir erros de conexão de atualização de local, especialmente quando o dispositivo troca de rede. Isso será lançado progressivamente (começando em 0%) depois que a versão for integrada.`

Mudanças de dependência e configuração

  • Remova a dependência de glide:cronet-integration no POM.xml.

v5.0.0 (12 de setembro de 2023)

Mudanças de dependência e configuração

  • Atualização do SDK do Navigation para a versão 5.x.
  • O minSdkVersion foi atualizado para a API 23.
  • A versão do Kotlin foi atualizada para 1.9.0.
  • Adicionamos dependência do Room. * Os apps que usam o SDK do Driver agora precisam ter targetSdkVersion da API 31 ou mais recente.
  • Os apps que usam o SDK do Driver agora precisam ativar o suporte à biblioteca do Java 8. Consulte https://developer.android.com/studio/write/java8-support para ver instruções de atualização.
  • Os apps que usam o Proguard ou o Dexguard precisam migrar para o R8. Consulte https://developer.android.com/build/shrink-code para mais informações.
  • Os apps que usam o SDK do Driver precisam ativar a simplificação. Consulte https://developer.android.com/studio/write/java8-support#library-desugaring para ver as instruções.

Correções de bugs

  • Correção de um problema com a sincronização de disableLocationTracking.
  • Introdução da nova interface DriverStatusListener, que informa uma causa nas atualizações de status de exceção.
  • Correção de um problema em que os motoristas permaneciam parados (disponível a partir da v4.99.0).

v4.99.0 (9 de agosto de 2023)

  • Suporte a uma variedade de versões para a dependência do NavSDK. ** Compatível com a v4.5.0 até (mas não incluindo) a v5.0.0.
  • Evitar que o HEC diminua sozinho quando o veículo estiver parado. Essa mudança será lançada gradualmente como um experimento, então nem todos os aplicativos vão receber essa mudança simultaneamente.

v4.5.0 (12 de maio de 2023)

  • Atualização da dependência do SDK de navegação para a versão 4.5. Os IDs de grupo e artefato do SDK do Navigation mudaram.

v4.4.3 (20 de março de 2023)

Mudança de dependência

  • Atualização da dependência do SDK do Navigation para a v4.4.1.

v4.4.2 (15 de fevereiro de 2023)

Correções de bugs

  • Melhoramos o tempo de recuperação da rede quando o SDK encontra um problema de conexão temporário. Esta é uma correção experimental.

  • Descarte as solicitações UpdateVehicle que contêm apenas um local "Bruto".

  • Correção de uma disputa na API ALPHA "Panorama do trajeto".

v4.4.1 (18 de novembro de 2022)

Correções de bugs

  • Correção de um bug na lógica de upload de tráfego.

Alterações adicionais

  • Melhorias internas nos cabeçalhos da solicitação e nos relatórios de código de status.

v4.4.0 (21 de setembro de 2022)

Correções de bugs

  • Correção de um bug que impedia a remoção da notificação "Dirigindo com o Google Maps" quando a instância da API não era limpa.

Mudança de dependência

  • Fazer upgrade da dependência do SDK do Navigation para a v4.2.2.

v4.3.0 (24 de agosto de 2022)

Melhorias internas.

Comunicado: congelamento do suporte para o Android 5 (21 de julho de 2022)

Para nossa versão mais recente do SDK (v4.2.0), estamos oferecendo mais um ano de suporte para apps executados no Android 5, para os níveis da API 21 e 22.

O que isso significa:

  • Os SDKs de navegação e do motorista em execução nos seus apps Android serão compatíveis com o Android 5 (nível 21 da API) até 30 de junho de 2023.
  • Depois de 30 de junho de 2023, vamos oferecer suporte apenas aos níveis 23 e mais recentes da API do Android. Em outras palavras, vamos deixar de oferecer suporte aos níveis 21 e 22 da API Android em todas as versões do SDK após essa data. Isso significa que os bugs relacionados ao Android 21 ou 22 em qualquer versão do SDK (incluindo a 4.x) não serão corrigidos, e não garantimos que os SDKs vão se comportar corretamente.

Este aviso substitui o aviso de congelamento de suporte do Android 21 e 22 de 21 de junho de 2021 e o congelamento de suporte do Android 23, 24 e 25 de 18 de outubro de 2021.

v4.2.0 (8 de junho de 2022)

Mudança de dependência

  • Fazer upgrade da dependência do SDK de navegação para a v4.1.3.
  • O nível mínimo da API Android com suporte foi reduzido para 21.

v4.1.0 (28 de abril de 2022)

Atualizações da API

  • A propriedade parentId do objeto Task foi renomeada como trackingId. A propriedade antiga ainda existe, mas foi descontinuada.

v4.0.0 (29 de novembro de 2021)

O nível mínimo da API Android com suporte para esta versão é o 23.

Atualizações da API

Para esta versão, o SDK do Driver para Android foi atualizado com as seguintes mudanças.

Mudança na API VehicleStops

Os objetos VehicleStop agora referenciam uma lista de objetos TaskInfo, em vez de uma lista de objetos Task. Se você precisar do estado da tarefa, recomendamos que o rastreie no código do aplicativo.

  • Adicionamos uma nova classe: TaskInfo.

  • A função getTasks de VehicleStop foi substituída pela função getTaskInfoList.

  • A função setTasks de VehicleStop.Builder foi substituída pela função setTaskInfoList.

Monitoramento de falhas

O monitoramento e a geração de relatórios de falhas foram adicionados para melhorar a estabilidade do SDK. Esse recurso é ativado por padrão, mas pode ser desativado se você chamar setAbnormalTerminationReportingEnabled() e transmitir um valor de false antes de inicializar o SDK.

getRemainingVehicleStops assíncrono

Autenticação

Propriedades desnecessárias foram removidas da interface AuthTokenContext. O uso de ServiceType foi descontinuado. Agora, você só precisa receber declarações para o ID do veículo e da tarefa incluídos, em vez de depender de ServiceType.

18 de outubro de 2021: congelamento do suporte para os níveis da API 23, 24 e 25

Leia o comunicado de 18 de outubro

Em resposta às mudanças nas nossas dependências internas, os níveis 23, 24 e 25 da API Android (Android 6, 7.0 e 7.1) não serão mais compatíveis com as novas versões dos SDKs de navegação e de driver para Android, a partir do terceiro trimestre de 2022.

As versões dos SDKs de navegação e de driver para Android lançadas a partir do terceiro trimestre de 2022 serão compatíveis apenas com dispositivos que executam pelo menos o nível 26 da API do Android.

As versões do app criadas com a v4.x ou anterior dos SDKs de navegação e de driver para Android vão continuar funcionando em dispositivos com o nível 25 da API do Android e versões anteriores.

v3.0.4 (28 de julho de 2021)

Recursos

Com esta versão, o SDK do Driver é oficialmente separado do SDK do Navigation. Para mais detalhes, consulte o Guia de migração.

Atualizações da API

Os seguintes métodos foram adicionados:

`RidesharingDriverApi.getDriverSdkVersion()`

Estabilidade e correções de bugs

Relatar erros PERMISSION_DENIED em vez de classificá-los como erros de conexão.

Aviso de descontinuação (21 de junho de 2021)

Este aviso descreve as descontinuações do SDK do Driver para Android e do SDK do Navigation para Android a partir da data listada acima. Este comunicado também foi enviado como um aviso obrigatório de serviço (MSA, na sigla em inglês) aos clientes afetados.

Para simplificar a integração do cliente e acelerar nossa capacidade de oferecer recursos úteis, estamos dividindo o SDK do Navigation para Android e o SDK do Driver para Android em dois binários diferentes:

  • SDK do Navigation para Android, que oferece funcionalidades de navegação/trajeto para seus motoristas.
  • SDK do Driver para Android, que permite usar os serviços da Web com estado do Fleet Engine para progresso e alocação de viagens ou tarefas.

O SDK do Driver para Android tem uma dependência obrigatória do SDK do Navigation para Android para funções de roteamento principais.

Quais são as mudanças?

As principais mudanças na v3 são:

  • Dois binários em vez de um.
  • Definições de pacote mais claras para as classes do SDK do Driver para Android.
  • O SDK do Navigation para Android inclui o SDK do Maps para Android como parte do pacote (a partir da v2 do SDK do Navigation para Android).
    • Isso permite que os recursos de mapas e navegação coexistam no mesmo mapa (como desenhar polilinhas em uma NavigationView) e reduz o uso da memória, já que um único mapa é usado em vez de dois.
    • O SDK do Navigation para Android 3.0 não tem paridade total de recursos com o SDK do Navigation para Android, mas a v3.2 vai resolver a maioria dos problemas aqui. Consulte O que posso fazer e quando? para mais detalhes.
  • Registros que facilitam a depuração de problemas que você pode encontrar.

Os métodos a seguir também foram removidos na v3, já que foram marcados como descontinuados e já têm uma solução alternativa:

  • Os seguintes métodos do SDK de navegação/motorista foram descontinuados na v1.16, lançada em 10 de agosto de 2020, e foram removidos na v3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Para fins de integridade e clareza, vários métodos foram removidos na transição da v1 para a v2. A maioria delas foi uma consolidação de classes duplicadas entre o SDK do Navigation para Android e o SDK do Maps para Android. Consulte o guia de migração para entender melhor essas mudanças.

Descontinuação do SDK do Driver para Android e do SDK do Navigation para Android v1.x

O SDK de navegação/driver v1 foi lançado em 2018. Com o lançamento iminente das versões v3, é hora de descontinuar a v1 para evitar a insustentabilidade de oferecer suporte a muitas versões principais.

O tempo economizado por não ter que oferecer suporte a essa versão adicional nos permitirá oferecer um suporte melhor à versão principal mais recente e criar mais recursos importantes para nossos clientes.

Portanto, a v1.x do SDK de navegação/driver foi descontinuada e não será mais mantida após 21 de junho de 2022.

Reserve um momento para conferir como funcionam as descontinuações em versões do SDK.

Ler aviso revogado

A próxima versão 4.0 do SDK de navegação para Android e do SDK do Driver para Android será compatível com o [Android 6.0 (nível 23 da API)](https://developer.android.com/studio/releases/platforms#6.0){: .external} como versão mínima. A versão mínima atual com suporte é o Android 5.0 (nível 21 da API). Prevemos o lançamento da v4.0 no quarto trimestre de 2021. Isso significa que:

  • As versões do app criadas com versões anteriores à v4.x vão continuar funcionando em dispositivos com o Android 21 e 22. Os apps de motorista que integraram nossos SDKs atuais vão continuar funcionando em dispositivos com o Android 21 ou mais recente. Isso é igual ao que já acontecia.
  • As versões do app criadas com o SDK do Driver para Android e o SDK do Navigation para Android v4.x (previsto para o quarto trimestre de 2021, sujeito a alterações) e versões mais recentes não poderão ser instaladas em dispositivos com o Android 21 e 22. A v4.x será executada no Android 6.0 (nível 23 da API) ou mais recente. Portanto, as versões do seu app criadas com a próxima v4.x só poderão ser recebidas por motoristas com dispositivos que tenham o Android 23 ou mais recente. Isso significa que as mudanças relacionadas ao SDK e as alterações que você fez no app não vão chegar aos motoristas com dispositivos que executam o Android 21 e 22.

As versões do SDK do Navigation para Android v3 e do SDK do Driver para Android v3 para as quais você vai fazer upgrade estão explicadas na tabela a seguir, junto com a data de lançamento.

Quais recursos da plataforma Driver você usa? Você usa esses recursos? As primeiras versões disponíveis para upgrade são… Disponibilidade esperada
(sujeita a mudanças)		 Links de migração
Somente navegação
(métodos do NavSDK)		 Não NavSDK v3.0.1 Agora Guia
Sim SDK de navegação v3.5 (estimativa) Setembro de 2021
Navegação e rastreamento do Fleet Engine (métodos NavSDK e DriverSDK) Não SDK de navegação v3.0 e SDK do Driver v3.0 Guia de migração do driver v3.0 disponível na versão
Sim SDK de navegação v3.x e SDK do Driver v3.0

Para continuar usando os métodos removidos, você pode permanecer na v1.x, mas sem expectativa de suporte ou manutenção após 21 de junho de 2022 (consulte a próxima seção).

Recomendamos que você migre para a v3.x. Isso significa que:

* A última versão da v1.x será lançada no quarto trimestre de 2021 (e, portanto, a v1 terá os recursos congelados a partir de então).

* Essa última versão pode receber patches por seis meses, até 21 de junho de 2022. Depois desse período, não será possível responder a solicitações de recursos ou bugs da v1.x.

Confira a tabela a seguir e o [guia de migração](/maps/documentation/navigation-sdk-android/v2/migration) para ajudar você a lidar com essas mudanças.

O que posso fazer e até quando?

Se você estiver usando... Você usa esses recursos? Para fazer upgrade agora Para fazer upgrade em setembro de 2021 Links de migração
v1.x
(não usando a funcionalidade FleetEngine.java / Driver) 		Não NavSDK v3.0 Guia
Sim Não há opção NavSDK 3.x
v1.x
(usando FleetEngine.java / funcionalidade do motorista)		 Não Não há opção SDK de navegação 3.x +
SDK do Driver 3.x		 O guia acima, além do guia de migração do Driver v3.0 disponível no lançamento.
Sim

Recomendamos que você notifique os motoristas com dispositivos Android 21 e 22 para que façam upgrade para uma versão mais recente do Android (mínimo Android 6.0) antes de integrar o SDK do Driver para Android e o SDK de navegação para Android versão 4.x e mais recentes ao app do motorista.

v1.15.3 (9 de outubro de 2020)

Atualizações da API

  • O SDK do Driver agora se inscreve no SDK do Navigation para receber atualizações de trânsito, que são enviadas à API Fleet Engine.

Estabilidade e correções de bugs

  • Correção de uma falha no ambiente de execução do gRPC.

v1.15.2

Recursos

Adicionamos a capacidade de interromper notificações persistentes. Se o relatório de local for interrompido na instância do Fleet Engine, as orientações serão interrompidas no Navigator, todos os listeners de navegação serão cancelados e o NavigationFragment ou o NavigationView será pausado.

Estabilidade e correções de bugs

  • Correção de um bug que causava uma exceção se a instância do Fleet Engine fosse limpa.

v1.15.1 (12 de maio de 2020)

Recursos

A análise preliminar dos dados da versão 1.15.0 indicou melhorias significativas nos relatórios de localização estáveis (redução de locais "travados"). Essa correção permite que o relatório de local aprimorado continue. O problema de ANR não estava relacionado a essas melhorias.

Estabilidade e correções de bugs

  • Correção de um bug que às vezes fazia com que uma linha reta no início da rota fosse mostrada no aplicativo para o consumidor.
  • Correção de um bug que poderia resultar em um ANR quando os locais são informados pelo SDK. Isso resultou de melhorias de onArrival() que eram suscetíveis à contenção de bloqueio. Conseguimos reproduzir ANRs de forma confiável em algumas circunstâncias e verificar se as correções resolveram o problema. O app de teste modificado para produzir os ANRs foi executado por oito horas sem um ANR após a correção.

v1.15.0 (23 de março de 2019)

Recursos

  • Introdução do status de orientação de navegação nos eventos de início, fora da rota e chegada para melhorar o rastreamento de localização do veículo.
  • Adicionamos a capacidade de continuar recebendo locais ajustados à via, independentemente do estado de navegação.
  • Adicionamos mais informações sobre locais pré-ajustados à via, como precisão.

Estabilidade e correções de bugs

  • Aumentamos a minSdkVersion do navsdk para 19.
  • Correção de um bug que fazia com que os nomes de pontos de passagem de latitude/longitude não fossem respeitados quando a geocodificação inversa do lado do servidor falhava.

Versão v1.14.2 (2 de fevereiro de 2019)

Recursos

  • Impede que o DriverSDK envie locais 0,0 para o Fleet Engine (melhor compartilhamento de jornada e entradas de local de alocação).
  • Mais registros para melhorar os problemas de localização travada e reduzir as substituições no compartilhamento de trajeto.
  • Ignore chamadas repetidas para setLocationReportingInterval(), a menos que o intervalo mude.
  • Atualizamos os javadocs do método setReportingInterval() com o objetivo de desencorajar a chamada repetida desse método em uma taxa alta em relação aos intervalos usados.
  • A confiabilidade da localização da API 29 foi melhorada.

v1.13.0

Estabilidade e correções de bugs

  • Adiciona uma dependência em okhttp que os clientes precisarão adicionar aos builds do Gradle.

v1.11.7 (18 de outubro de 2019)

Estabilidade e correções de bugs

  • As atualizações de local agora continuam depois que onArrival() é acionado para um determinado destino.
  • A notificação padrão (uma string constante no modo de navegação livre) corresponde ao esquema de cores definido para as notificações de navegação. Para mais informações, consulte Notificações persistentes compartilhadas.
  • Foi resolvido um problema em que um evento de atualização do local atrasado podia causar uma atualização do local falsa, gerando artefatos como uma linha reta no início de uma rota.

v1.11.6 (4 de outubro de 2019)

Atualizações da API

  • Introduzimos uma série de mudanças que garantem que o SDK do Driver retome as atualizações de local rapidamente após uma falha de rede. Depois que a conexão de rede for restaurada, as atualizações do local serão retomadas na próxima atualização programada.

Estabilidade e correções de bugs

  • setVehicleState() agora retorna imediatamente. A atualização do FleetEngine agora ocorre em uma linha de execução em segundo plano. Resolve um problema de ANR (O app não está respondendo).
  • Corrigimos um problema que fazia com que os trajetos de compartilhamento de percurso fossem exibidos como uma linha reta ao usar versões mais antigas do SDK do Consumidor. Garante que nenhum ponto de passagem único seja adicionado ao trajeto pelo SDK do Driver.