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.

v5.0.0 (12 de setembro de 2023)

Dependências e mudanças de configuração

  • Atualização do Navigation SDK para a v5.x.
  • Atualização de minSdkVersion para a API 23.
  • Atualização da versão do Kotlin para 1.9.0.
  • Foi adicionada uma dependência da Room.
  • Os apps que usam o SDK do Driver agora precisam ter o targetSdkVersion da API 31 ou mais recente.
  • Os apps que usam o SDK do Driver agora precisam ativar o suporte à biblioteca Java 8. Consulte https://developer.android.com/studio/write/java8-support para ver instruções de atualização.
  • Os apps que usam Proguard ou Dexguard precisam migrar para o R8. Consulte https://developer.android.com/build/tuning-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 instruções.

Correções de bugs

  • Foi corrigido um problema com a sincronização dedisableLocationTracking.
  • Introdução da nova interface DriverStatusListener que informa uma causa nas atualizações de status de exceções.
  • Correção do problema para motoristas que ficavam parados (disponível a partir da v4.99.0).

v4.99.0 (9 de agosto de 2023)

  • Ofereça suporte a várias versões para a dependência do NavSDK. ** Compatível com a v4.5.0 até a v5.0.0 (não incluindo a v5.0.0).
  • Evite que o HEC diminua sozinho quando o veículo estiver parado. Essa mudança será lançada gradualmente como um experimento. Por isso, ela não vai aparecer para todos os apps simultaneamente.

v4.5.0 (12 de maio de 2023)

  • A dependência do SDK do Navigation para v4.5 foi atualizada. Os IDs de grupo e artefato do SDK do Navigation mudaram.

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

Mudança na dependência

  • Upgrade da dependência do SDK do Navigation para v4.4.1.

v4.4.2 (15 de fevereiro de 2023)

Correções de bugs

  • Melhoria no tempo de recuperação da rede quando o SDK encontra um problema temporário de conexão. Esse recurso está sendo lançado como um experimento.

  • Descartar solicitações UpdateVehicle que contenham apenas um valor "RAW" o local.

  • Corrigir a disputa na "Visão geral da rota" API ALPHA.

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 em cabeçalhos de solicitação e relatórios de código de status.

v4.4.0 (21 de setembro de 2022)

Correções de bugs

  • Corrigiu um bug que impedia a mensagem "Como dirigir com o Google Maps" de ser removida se a instância da API não tiver sido apagada.

Mudança na dependência

  • Upgrade da dependência do SDK do Navigation para v4.2.2.

v4.3.0 (24 de agosto de 2022)

Melhorias internas.

Anúncio: congelamento do suporte ao Android 5 (21 de julho de 2022)

Para nossa versão mais recente do SDK (v4.2.0), estamos fornecendo um ano adicional de suporte para apps executados no Android 5, tanto para APIs de nível 21 e 22.

O que isso significa:

  • O SDK do Navigation e do Driver em execução nos seus apps Android serão compatíveis com uma No mínimo, o Android 5 (nível 21 da API) até 30 de junho de 2023.
  • Após 30 de junho de 2023, vamos oferecer suporte apenas ao nível 23 da API do Android ou versões mais recentes. Em outras palavras, não ofereceremos mais suporte para os níveis 21 e 22 das APIs do Android em todas as versões do SDK após essa data. Isso significa que bugs relacionados ao Android 21 ou 22 em qualquer versão do SDK (incluindo a 4.x) não será corrigida. Além disso, garantir que os SDKs se comportem corretamente.

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

v4.2.0 (8 de junho de 2022)

Mudança na dependência

  • Upgrade da dependência do SDK do Nav para a v4.1.3.
  • Faz o downgrade do nível mínimo da API do Android com suporte para 21.

v4.1.0 (28 de abril de 2022)

Atualizações da API

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

  • Alguns tipos de retorno foram alterados de Future para um tipo mais específico ListenableFuture e de List para um ImmutableList mais específico.

v4.0.0 (29 de novembro de 2021)

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

Atualizações da API

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

Mudança na API VehicleStops

Os objetos VehicleStop agora fazem referência a uma lista de TaskInfo em vez de uma lista de Task objetos. Se você precisar do estado da tarefa, você é incentivado a rastreá-lo em seu código de aplicativo.

  • Nova turma adicionada: TaskInfo

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

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

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 é possível desativá-lo se você chamar setAbnormalTerminationReportingEnabled() e transmita a ele um valor de false antes de inicializar o SDK.

Async getRemainingVehicleStops

Autenticação

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

18 de outubro de 2021: congelamento do suporte aos níveis 23, 24 e 25 das APIs

Leia o aviso de 18 de outubro

Em resposta a mudanças em nossas dependências internas, o nível 23 da API do Android, As versões 24 e 25 (Android 6, 7.0 e 7.1) não serão compatíveis com as novas versões dos SDKs de navegação e driver para Android, começando no terceiro trimestre de 2022.

SDKs de navegação e driver para versões do Android lançadas a partir do terceiro ano de 2022 será compatível apenas com dispositivos que executem pelo menos API do Android de nível 26.

Versões do app criadas com a v4.x ou anterior dos SDKs de navegação e driver para O Android vai continuar funcionando em dispositivos com o nível 25 da API do Android. e abaixo dela.

v3.0.4 (28 de julho de 2021)

Recursos

Com este lançamento, o SDK do Driver é oficialmente separados do SDK do Navigation. Consulte a guia de migração para mais detalhes.

Atualizações da API

Os seguintes métodos foram adicionados:

DeliveryDriverApi.getDriverSdkVersion()

Estabilidade e correções de bugs

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

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

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

Simplificar a integração do cliente e acelerar nossa capacidade de fornecer resultados estamos dividindo o SDK do Navigation para Android e SDK do Driver para Android em dois binários diferentes:

  • SDK do Navigation para Android, que fornece navegação/roteamento para os motoristas.
  • SDK do Driver para Android, que permite usar o Fleet Engine para o progresso e alocação de viagens ou tarefas.

O SDK do Driver para Android depende de 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 do SDK do Navigation para Android v2).
    • Isso permite que mapas e recursos de navegação coexistam no mesmo mapa (como desenhar polilinhas em uma NavigationView) e reduz o uso de 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 resolverá a maioria dos problemas aqui. Consulte O que posso fazer e quando? para mais detalhes.
  • Logging, que facilitará a depuração dos problemas que você encontrar.

Os métodos a seguir também foram removidos na v3, tendo sido marcado como descontinuado e para o qual já existe uma solução alternativa existe:

  • Os seguintes métodos do SDK do Nav/Driver foram descontinuados na v1.16, lançada na 10 de agosto de 2020 e removidas na v3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • Para maior abrangência e clareza, note que vários métodos foram removidos na transição da v1 para a v2. A maioria desses documentos foi consolidação de dados entre o SDK do Navigation para Android e o SDK do Maps para Android. Consulte a 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 Nav/Driver SDK v1 foi lançado em 2018 e, com nossas versões v3 em breve, lançada, é hora de descontinuar a v1 para evitar a insustentabilidade dos e é compatível com muitas versões principais.

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

Portanto, o SDK Nav/Driver v1.x foi descontinuado e não será mais mantido. após 21 de junho de 2022.

Reserve um momento para ver Saiba como funcionam as descontinuações de versões do SDK.

Ler o aviso de revogação

A próxima versão 4.0 do SDK do Navigation para Android e O SDK do Driver para Android terá suporte a um mínimo [Android 6.0 (nível 23 da API)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. A versão mínima compatível atual é o Android 5.0 (nível 21 da API). A previsão é de lançar a v4.0 no 4o trimestre de 2021. Isso significa que:

  • As versões do aplicativo criadas com versões anteriores à v4.x continuarão funcionando Dispositivos Android 21 e 22. Seus apps para motoristas que integraram nossa Os SDKs atuais vão continuar funcionando em dispositivos com o Android 21 ou versões mais recentes. É o mesmo de antes.
  • As versões do app criadas com o SDK do Driver para Android e SDK do Navigation para Android v4.x (direcionado para no quarto trimestre de 2021 (sujeita a mudanças) e versões posteriores não poderão ser instaladas no dispositivos com o Android 21 e 22. v4.x será executado, no mínimo, com o Android 6.0 (nível 23 da API), Portanto, as versões do aplicativo criadas com a próxima v4.x só podem ser recebidos por motoristas com dispositivos com o Android 23 ou versões mais recentes. Para reforçar, isso significa que nossas alterações relacionadas ao SDK e quaisquer alterações no aplicativo que você não alcançarão motoristas com dispositivos com o Android 21 e 22.

As versões do SDK do Navigation para Android v3 e SDK do Driver para Android v3 para o qual será feito upgrade estão disponíveis na tabela a seguir e também quando eles estarão disponíveis.

Quais recursos da plataforma do Driver você usa? Você usa esses recursos? Então, as primeiras versões disponíveis para as quais você deve fazer upgrade são... Disponibilidade esperada
(sujeita a mudanças)		 Links de migração
Somente navegação
(métodos NavSDK)		 Não NavSDK v3.0.1 Agora Guia
Sim NavSDK v3.5 (projetado) Setembro de 2021
Navigation e rastreamento do Fleet Engine (métodos NavSDK e DriverSDK) Não Nav SDK v3.0 e Driver SDK v3.0 Guia de migração do driver v3.0 disponível na versão
Sim NavSDK v3.x e DriverSDK 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:

* O último lançamento da v1.x será no 4o trimestre de 2021 (e, portanto, a v1 “características congeladas” a partir de então).

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

Reserve um momento para analisar a tabela a seguir e as [guia de migração](/maps/documentation/navigation-sdk-android/v2/migration) no para ajudar você a navegar por essas mudanças.

O que posso fazer até quando?

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

Recomendamos que você notifique os motoristas que usam dispositivos com Android 21 e 22. para fazer upgrade para uma versão mais recente do Android (no mínimo 6.0) antes de integrar o SDK do Driver para Android e o SDK do Navigation para Android a versão v4.x ou mais recente ao aplicativo do driver.

v1.15.3 (9 de outubro de 2020)

Atualizações da API

  • O SDK do Driver agora se inscreve no SDK do Navigation para atualizações de tráfego, que são enviados à 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

Adicionada a capacidade de interromper notificações persistentes. Se o Relatório de localização é interrompida na instância do Fleet Engine, a orientação é interrompida em Navigator; todos os listeners de navegação não estão registrados, e NavigationFragment ou NavigationView está pausado.

Estabilidade e correções de bugs

  • Correção de um bug que fazia com que uma exceção fosse gerada se a instância do Fleet Engine fosse apagada.

v1.15.1 (12 de maio de 2020)

Recursos

A análise preliminar dos dados da versão 1.15.0 indicaram melhorias significativas em relatórios de localização estáveis (redução de locais "presos"). Esta correção de patch permite que os relatórios de localização aprimorados continuem. O problema de ANR não estava relacionado para essas melhorias.

Estabilidade e correções de bugs

  • Correção de um bug que às vezes causava uma linha reta no início do trajeto a ser exibido no aplicativo para o consumidor.
  • Correção de um bug que poderia resultar em um ANR quando os locais eram informados pelo SDK. Isso é resultado de onArrival() melhorias que foram suscetíveis à contenção de bloqueio. Conseguimos reproduzir os ANRs de maneira confiável sob algumas circunstâncias e verificamos se as correções foram resolvidas 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

  • Introduziu o status das orientações de navegação nos eventos de partida, saída e chegada. para melhorar o rastreamento da localização de veículos.
  • Agora é possível continuar recebendo informações de locais fotográficos de forma independente. do estado de navegação.
  • Adicionadas informações adicionais sobre locais pré-marcados, como precisão.

Estabilidade e correções de bugs

  • Aumento da minSdkVersion de navsdk para 19.
  • Correção de um bug que fazia com que os nomes de waypoints de latitude/longitude não fossem atendidos quando a geocodificação inversa do lado do servidor falha.

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

Recursos

  • Impede que o DriverSDK envie 0.0 locais para o Fleet Engine (melhor compartilhamento de jornada e entradas de local de alocação).
  • Geração de registros adicional para melhorar problemas de localização travada e reduzir substitutos para o compartilhamento de jornadas.
  • Ignorar chamadas repetidas para setLocationReportingInterval(), a menos que o intervalo mude.
  • O Javadoc foi atualizado para o método setReportingInterval() com o objetivo. de desencorajar chamadas repetidas desse método em uma taxa alta aos intervalos que estão sendo usados.
  • A confiabilidade do local da API 29 foi aprimorada.

v1.13.0

Estabilidade e correções de bugs

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

v1.11.7 (18 de outubro de 2019)

Estabilidade e correções de bugs

  • As atualizações de localização agora continuam depois que onArrival() é disparado por um determinado destino.
  • A notificação padrão (uma string constante no modo de navegação livre) corresponde à esquema de cores definido para as notificações de navegação. Para mais informações, consulte Notificações persistentes compartilhadas.
  • Resolvemos um problema em que um evento de atualização de local atrasado poderia causar uma atualização falsa de localização, causando artefatos como uma linha reta no início de um trajeto.

v1.11.6 (4 de outubro de 2019)

Atualizações da API

  • Introduziu uma série de mudanças para garantir que o SDK do driver seja retomado local é atualizado rapidamente após uma falha de rede. Depois que a conexão de rede foi restaurado, as atualizações de local começam novamente no próximo local programado atualizar.

Estabilidade e correções de bugs

  • setVehicleState() agora retorna imediatamente. A atualização do FleetEngine agora ocorre em segundo plano fio Resolve um problema "O app não está respondendo" (ANR).
  • Correção de um problema que fazia com que as rotas de compartilhamento de jornada fossem exibidas como um usando versões mais antigas do SDK do consumidor. Garante que nenhuma waypoints únicos são adicionados ao trajeto pelo SDK do Driver.