Notas da versão do SDK de consumidor para Android

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

2.3.0 (2 de agosto de 2024)

Mudanças na API

2.2.0 (7 de maio de 2024)

Mudanças na API

  • API de suporte adicionada para integração com o Jetpack Compose. Este é um experimento . Para mais detalhes sobre a integração com o Jetpack Compose, entre em contato com com seu representante.

2.1.0 (17 de janeiro de 2024)

Correções de bugs

  • Corrige falhas que ocorrem quando o SDK é inicializado mais de uma vez o ciclo de vida do aplicativo.

Mudanças na API

  • Apresenta o método para recuperar a instância GoogleMap criada pelo SDK (ConsumerGoogleMap.getGoogleMap()).
  • Introdução da API para recuperar as instâncias Marker criadas pelo SDK para representam o veículo (ConsumerController.getConsumerMarker()).
  • Introdução de APIs para receber atualizações projetadas pelo cliente de tempo e distância durante o Compartilhamento da jornada (ProjectedRouteEta).

1.99.2 (3 de novembro de 2023)

  • Corrige falhas que ocorrem quando o SDK é inicializado de um processo remoto. separadamente do aplicativo.

  • Corrige falhas que ocorrem durante a execução de uma animação de câmera e não há espaço vertical ou horizontal suficiente para o padding. Isso ocorre apenas no renderizador de mapas mais recente.

  • Corrige o bug que faz com que o primeiro trecho de uma viagem de ida e volta seja cortado quando o segundo trecho passa pela mesma estrada.

Problemas

  • O ConsumerApi.initialize() gera uma exceção se for invocado quando uma instância da API já existir. Para contornar isso, primeiro chame ConsumerApi.getInstance() e avalia o Task retornado para determinar se uma instância de API já existe.

2.0.0 (15 de setembro de 2023)

Anúncio: alterações interruptivas

  • O requisito mínimo de nível da API foi atualizado de 21 para 23.

  • Atualização do requisito de versão do SDK do Maps de v17.0.0 para v18.1.0

  • O requisito mínimo da versão da biblioteca padrão do Kotlin foi atualizado da v1.6.10 para a v1.9.0.

  • Atualizar as versões de dependências do Google Play Services

    • O requisito mínimo da versão da biblioteca play-services-base foi atualizado de v18.0.1 a v18.2.0

    • O requisito mínimo da versão da biblioteca play-services-basement foi atualizado Da v18.0.0 para a v18.2.0

    • O requisito mínimo de versão da biblioteca play-services-location foi atualizado da v17.0.0 para a v21.0.1.

    • O requisito mínimo da versão da biblioteca play-services-tasks foi atualizado de v18.0.1 a v18.0.2

  • Adiciona a biblioteca androidx.room:room-runtime com o requisito de versão mínima definido. para a v2.5.2

  • Atualize as versões das seguintes dependências

    • O requisito mínimo da versão da biblioteca android-maps-utils foi atualizado de v0.4.2 a v3.5.2

    • O requisito mínimo de versão com.google.android.datatransport:transport-backend-cct foi atualizado da v3.0.0 para a v3.1.9.

    • O requisito mínimo de versão com.google.android.datatransport:transport-runtime foi atualizado da v3.0.1 para a v3.1.9.

    • O requisito mínimo da versão androidx.lifecycle:lifecycle-extensions foi atualizado da v2.0.0 para a v2.2.0.

    • O requisito mínimo da versão androidx.lifecycle:lifecycle-common-java8 foi atualizado da v2.0.0 para a v2.6.1.

    • O requisito mínimo da versão androidx.appCompat:appCompatibilidade foi atualizado de v1.0.0 a v1.6.1

    • O requisito mínimo de versão do androidx.fragment:fragment foi atualizado de v1.0.0 para v1.6.1.

  • Remove as seguintes APIs descontinuadas: ConsumerTrip, ConsumerTripCallback, ConsumerTripManager e ConsumerTripOptions. Eles foram substituídos por TripModel, TripModelCallback, TripModelManager e TripModelOptions.

  • Os apps que usam o SDK do consumidor agora precisam ter targetSdkVersion da API 31 ou mais recente, compileSdkVersion da API 33 ou mais recente.

  • Os apps que usam o SDK para consumidores agora precisam ativar o Java 8 suporte a bibliotecas. Consulte https://developer.android.com/studio/write/java8-support para 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 consumidor precisam ativar a simplificação. Consulte https://developer.android.com/studio/write/java8-support#library-desugaring para ver instruções.

  • O método ConsumerApi.initialize() agora gera uma exceção se estiver sendo invocado quando já houver uma instância da API criada. A Task retornou por ConsumerApi.getInstance() precisa ser usado para determinar se há uma API uma instância criada anteriormente.

Aviso: descontinuação de APIs

  • As classes de anotação Trip.TripStatus e Trip.TripType foram descontinuadas. As classes de anotação TripInfo.TripStatus e TripInfo.TripType foram adicionadas para substituí-las.

    • Como parte dessa mudança, TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status) foi descontinuado e TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status) foi adicionado para substituí-lo.

    • Como parte dessa mudança, TripInfo#getTripStatus() foi descontinuado, e TripInfo#getCurrentTripStatus() foi adicionado para substituí-lo.

    • Como parte dessa mudança, TripInfo#getTripType() foi descontinuado, e TripInfo#getCurrentTripType() foi adicionado para substituí-lo.

  • A classe Trip foi descontinuada.

Outras alterações e correções de bugs

  • Suporte a solicitações do renderizador mais recente do SDK do Maps. Consulte Novo renderizador de mapas. para mais detalhes.

  • Oferece suporte ao intervalo do SDK do Maps das versões 18.1.0(inclusive) a v19.0.0(exclusivas).

  • Corrige "prazo excedido" nas comunicações internas entre o SDK e back-end do Google.

  • Correção do problema de renderização para telas de tamanho pequeno e modo picture-in-picture.

Guia de migração

1.99.1 (31 de agosto de 2023)

Correções de bugs

  • Corrige a falha que ocorre quando a atividade ou o fragmento do host do SDK são destruídos.

  • Correção da falha que ocorre quando as dimensões do MapView são 0 (altura ou largura).

  • Correção de falha que ocorre ao projetar o local do veículo na polilinha da rota.

Melhorias

  • Impede que o SDK falhe quando o aplicativo host é instalado por sideload e os recursos visuais padrão não estão presentes.

1.99.0 (22 de junho de 2023)

Correções de bugs

  • Correção do problema de renderização para telas pequenas e para o modo picture-in-picture.

  • Correção de oscilações do veículo durante o compartilhamento de trajetos.

1.2.1 (7 de junho de 2023)

Correções de bugs

  • Correção de um bug que fazia o veículo piscar durante o compartilhamento da viagem.

1.2.0 (21 de novembro de 2022)

Correções de bugs

  • Corrige o bug que fazia com que o tráfego vazio fosse informado no onTripActiveRouteTrafficUpdated.

Novos recursos

  • "Polilinhas com reconhecimento de trânsito" já está disponível para todos os usuários.

1.1.2 (27 de outubro de 2022)

Correções de bugs

  • Bug de endereços que faz com que a polilinha do trajeto desapareça após um JourneySharingSession é iniciado mais de uma vez para um TripModel.

Anúncio: congelamento do suporte para o Android 5 (25 de julho de 2022)

Para a versão v1.1.1 do SDK, estamos oferecendo mais um ano de suporte para apps executados no Android 5, para os níveis 21 e 22 da API.

O que isso significa:

  • O SDK do consumidor em execução nos seus apps Android vai oferecer suporte a, no mínimo, o Android 5 (nível 21 da API) até 30 de junho de 2023.

  • Após 30 de junho de 2023, só vamos oferecer suporte aos níveis 23 e mais recentes da API do Android. 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 os bugs relacionados ao Android 21 ou 22 em qualquer versão do SDK (incluindo 4.x) não serão corrigidos, e não garantimos que os SDKs vão se comportar corretamente.

v1.1.1 (25 de julho de 2022)

Mudança de dependência

  • O nível mínimo da API do Android com suporte foi rebaixado para 21.

v1.1.0 (28 de abril de 2022)

  • Melhorias internas.

v1.0.19 (17 de março de 2022)

Correções de bugs

  • Correção de um vazamento de memória na classe ConsumerApi.

v1.0.14 (30 de novembro de 2021)

O nível mínimo da API Android com suporte agora é 23.

Mudanças na API

  • Mudanças nas classes ConsumerTrip e ConsumerTripManager.

    • Limpeza de alguns nomes de métodos para deixar o significado mais claro e alinhar com a plataforma iOS.

  • Mudanças em ConsumerTripCallback, ConsumerTrip e TripInfo.

    • Alguns nomes de classe foram alterados para formar paridade com o iOS. Introdução de TripModel, TirpModelManager e TripModelOptions para descontinuar ConsumerTrip, ConsumerTripManager e ConsumerTripOptions.

    • Limpeza de alguns nomes de métodos. Revisou ou adicionou comentários JavaDoc para e métodos para transmitir significados mais claros.

    • Tratamento de erros aprimorado.

Personalização de estilo

  • Wrappers legados descontinuados

    • MarkerStyleOptions e PolylineStyleOptions foram descontinuados e substituídos por MarkerOptions e PolylineOptions, que são compartilhados com o SDK do Maps.

Monitoramento de falhas

  • Adição de detecção de falhas e registro.

    • Fizemos uma adição para permitir que você desative essa funcionalidade. Isso foi feito como parte de um esforço maior em toda a região geográfica para monitoramento de falhas.

Alterações na autenticação

  • Métodos desnecessários foram removidos das interfaces de autenticação.
    • O parâmetro ServiceType foi removido.

v0.9.28 (18 de maio de 2021)

Mudanças na API

  • Todos os métodos ConsumerTripCallback foram atualizados para usar TripInfo como o .
  • Adição de ConsumerTrip.isRefreshing(), que indica se ConsumerTrip está se atualizando ativamente com novas informações de viagem do Fleet Engine.
  • ConsumerTripCallback.onTripRemainingRouteDistanceUpdated() foi adicionado.
  • ConsumerTripCallback.onTripRemainingRouteUpdated() foi adicionado.
  • Substitua os tipos de retorno do Guava (ImmutableSet, ImmutableList) por classes equivalentes de java.util.

  • Alterações no nome do pacote:

    • com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
    • com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory

    • com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip

                                  ->
                                                            com.google.android.libraries.ridesharing.consumer.model.Trip

                            -   com.google.android.libraries.ridesharing.common.model.Vehicle

                                                    ->
                                com.google.android.libraries.ridesharing.consumer.model.Vehicle

Mudanças na implementação

  • Correção de uma disputa em que o SDK podia falhar a partir de interações com o no mapa antes de ficar pronta.
  • O SDK não contém mais uma cópia não ofuscada de io.grpc.
  • Correção de um bug com polilinhas de tráfego piscando em determinados dispositivos. Tráfego agora terão extremidades arredondadas.

v0.9.15 (7 de outubro de 2020)

Mudanças na API

  • Esta versão introduz o Traffic Aware Polilinhas. - Adição de TripInfo.getActiveRouteTraffic() e TripInfo.getRemainingRouteTraffic().
    • ConsumerTripCallback.onTripActiveRouteTrafficUpdated() e ConsumerTripCallback.onTripRemainingRouteTrafficUpdated() foram adicionados para indicar quando o tráfego mudou.
    • Adição de PolylineStyleOptions para personalização de tráfego (setTrafficEnabled(), setTrafficColorNoData(), setTrafficColorNormal(), setTrafficColorSlow(), setTrafficColorTrafficJam()).
    • Exposição de PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION.
    • TripWaypoint.getTrafficData() foi adicionado.
    • Tipo de dados TrafficData adicionado.
    • ConsumerController.hideAllSessions() foi adicionado. A ConsumerController.showSession() não aceita mais null como um argumento.

v0.9.9 (15 de julho de 2020)

Mudanças na API

  • Essa é uma grande mudança que introduz uma arquitetura modularizada com uma uma relação mais clara entre a camada somente de dados (por exemplo, ConsumerTripManager) e a camada de interface do usuário (por exemplo, JourneySharingSession). Para mais informações sobre como migrar do Cloud, consulte o artigo Migração de modularização Guia (em inglês). - O objeto ConsumerTrip agora está obtido de ConsumerTripManager.getTrip().
    • ConsumerTrip.unregisterCallback foi renomeado como ConsumerTrip.unregisterTripCallback.
    • ConsumerTrip.isCallbackRegistered foi renomeado como ConsumerTrip.isTripCallbackRegistered.
    • Os elementos ConsumerTrip.setConsumerTripOptions() e a ConsumerTrip.getConsumerTripOptions() foram adicionados.
    • ConsumerTrip.setAutoRefreshInterval() foi removido.
  • Remoção de APIs sem compartilhamento de jornada.
    • O mapa de densidade de veículos foi removido.
    • Estado de visualização da viagem removido.
    • O estado de seleção de retirada foi removido.
    • O estado de seleção de entrega foi removido.
    • Os seguintes tipos de marcador foram removidos: SELECTED_PICKUP_POINT, SUGGESTED_PICKUP_POINT, HIGHLIGHTED_PICKUP_POINT e SELECTED_DROPOFF_POINT.
  • OnConsumerMarkerClickCallback e ConsumerMapReadyCallback foram alterados de interfaces para classes abstratas.
  • ConsumerController.getCameraUpdate(), ConsumerController.isAutoCameraEnabled() e ConsumerController.enableAutoCamera() foram adicionados.
  • Remoção do FAB personalizado e dos métodos associados a ele (ConsumerController.isMyLocationFabEnabled e ConsumerController.setMyLocationFabEnabled).

Mudanças na implementação

  • Um ConsumerTripCallback, registrado com ou sem um LifecycleOwner, não cancela mais a inscrição automaticamente em TripStatus.COMPLETE ou TripStatus.CANCELED.
  • AutoCamera agora está ativado por padrão e nunca é reativado ou desativado. Antes, a AutoCamera era reativada automaticamente no TripStatus.ARRIVED_AT_PICKUP e desativada quando o usuário interagia com o mapa durante o compartilhamento de trajeto.
  • As seguintes melhorias foram feitas no veículo de compartilhamento de viagens animação:
    • A animação de compartilhamento da jornada agora lida com a situação em que um veículo pode voltar legitimamente por uma rota já percorrida.
    • A animação do veículo será feita em linha reta em vez do trajeto interpolar entre pontos quando é determinado por algoritmos como sendo apropriados.
  • As permissões FINE_LOCATION não são mais necessárias.

Outras mudanças

  • As seguintes versões de dependência foram atualizadas:
    • com.google.android.datatransport:transport-api:2.2.0
    • com.google.android.datatransport:transport-backend-cct:2.2.0
    • com.google.android.datatransport:transport-runtime:2.2.0

v0.9.1 (23 de março de 2020)

Mudanças na API

  • TripInfo.getVehicleId(), TripInfo.getNumberOfPassengers(), TripInfo.getIntermediateDestinationIndex(), TripInfo.getTripActiveRoute() e TripInfo.getTripRemainingRoute() foram adicionados.
  • Adição da classe options usada durante a inicialização do ConsumerApi, que permite que o endereço FleetEngine seja definido dinamicamente. Se a API não for chamada com uma FleetEngine, ele tenta buscá-lo no manifesto do Android ou caso contrário, retorna ao valor padrão.

Melhorias

  • A polilinha do trajeto não aparece quando o status da viagem é ARRIVED_AT_PICKUP:
  • O rastreamento de veículos fora da rota foi aprimorado (requer o DriverSDK 1.15):
    • O rastreamento do veículo não fixa o veículo na rota quando ele passa pelo ponto de retirada.
    • O rastreamento de veículos permite que ele seja mostrado fora da estrada. para em estacionamentos não mapeados.
  • O ícone do veículo é atualizado quando o destino do motorista não corresponde o destino no Fleet Engine.

v0.8.6 (16 de dezembro de 2019)

Mudanças na API

  • TripInfo.getVehicleLocation() foi adicionado.

  • ConsumerMapView não é mais final.

Mudanças na implementação

  • A distância restante do trecho ativo agora é calculada usando a distância do servidor (informação informada pelo motorista + rota estática, quando aplicável) em vez de ajuste local. Essa alteração produz valores de distância restantes mais precisos.

Outras mudanças

  • Novas dependências necessárias. Para mais detalhes, consulte o arquivo .pom.

    • com.google.android.datatransport:transport-api:2.0.0
    • com.google.android.datatransport:transport-backend-cct:2.0.2
    • com.google.android.datatransport:transport-runtime:2.0.0

  • Foram adicionados registros para a latência da solicitação de viagem.

  • Registros de erros de resposta de viagem foram adicionados.

Observações

  • Desde a versão 0.8.1, o SDK do consumidor para Android é enviado como um arquivo zip jetificado. Para saber como desfazer a jetificação, consulte Jetifier: modo reverso.

v0.8.1 (13 de setembro de 2019)

Novos recursos

Mudanças na API

  • Adicionamos ConsumerController.disableAutoCamera() como a função oposta a centerMapForState().

  • VehicleLocation.getUpdateTime() agora retorna um longo que representa em milissegundos.

  • A interface AuthTokenFactory foi simplificada para expor um único método de geração de tokens. AuthTokenFactory foi modificado de uma interface para uma classe abstrata para permitir a compatibilidade com versões anteriores no Java7. Essa mudança é compatível com versões anteriores, mas os métodos antigos para geração de tokens de serviço único foram descontinuados e serão removidos.

Mudanças na implementação

  • Os recursos agora estão centralizados no centro do ícone, eliminando o deslocamento de sombra.

  • setState para JOURNEY_SHARING onStartTripMonitoring() em vez de esperar para o status da viagem monitorada.

  • Sempre retorna dados para a primeira atualização dos dados da viagem, mesmo quando eles estão indisponíveis de sincronização.

  • Foram adicionados os Utils do Mapa do Android como uma dependência fornecida.

Correções de bugs

  • Correção da sintaxe de exportação do proguard para grpc keep.

v0.7.0 (7 de agosto de 2019)

Novos recursos

  • Suporte a vários destinos para o Compartilhamento de jornadas.

Mudanças na API

  • Novos métodos para ConsumerTripCallback.

    • onTripIntermediateDestinationsUpdated().
    • onTripETAToNextTripWaypointUpdated().

  • Novos métodos ConsumerController.

    • getIntermediateDestinations().
    • setIntermediateDestinations(List<TerminalLocation> intermediateDestinations).

  • Novo TripStatuses.

    • TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION.
    • TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION.

  • Novos getters TripWaypoint.

    • getETAMillis().
    • getDistanceMeters().

  • A classe TripInfo foi adicionada.

    • Você pode receber TripInfo para a viagem ativa com ConsumerTripManager.getActiveTripInfo().

  • WaypointType.INTERMEDIATE_DESTINATION foi adicionado.

  • MarkerType.TRIP_INTERMEDIATE_DESTINATION foi adicionado.

  • ConsumerMapState.JOURNEY_SHARING foi criado a partir de ConsumerMapStates ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ENROUTE_TO_DROPOFF e COMPLETE mesclados.

    • A tabela StateChangeCallbacks foi atualizada.

    • onStateJourneySharing() foi adicionado.

    • onStateWaitingForPickup(), onStateDriverArrived(), onStateEnroute() e onStateEndofTrip() foram removidos.

Correções de bugs

  • Correção de um bug em que a rota não era ajustada ao local do veículo quando o monitoramento da viagem começava no meio de uma viagem ativa (não no início da rota).

  • Correção de um bug em que os callbacks de viagem não são invocados para listeners registrados no o Tripmanager depois que o TripManager já tiver buscado os dados da viagem.

  • O zoom da câmera agora inclui apenas o trajeto ativo e o próximo waypoint da viagem (waypoint que pertence à viagem). Mesmo que a etapa restante esteja visível, o zoom nunca vai incluí-la. Antes, o ponto de entrega era incluído no zoom quando o veículo estava a caminho de embarque ou chegou ao retirada. Isso não é mais verdade.

Melhorias

  • Preencher o ponto de passagem zero restante com dados do motorista (a lista de pontos de passagem restantes é retornada de ConsumerTripCallback.onTripRemainingWaypointsUpdated e TripInfo.getRemainingWaypoints()).

  • Atualizar todos os HECs restantes do waypoint quando for o primeiro waypoint da mudanças na lista.

  • Forçar a reativação da câmera automática apenas quando o motorista chega no local de embarque. Antes, a câmera automática era redefinida para ativada a cada mudança de estado da viagem. A câmera automática ainda está ativada por padrão. A câmera automática não será reativada se uma nova viagem ativa for definida sem uma nova chamada para startTripMonitoring().

v0.6.1 (26 de junho de 2019)

Novos recursos

  • Suporte para compartilhamento de viagens.

Mudanças na API

  • ConsumerController.getConsumerMapStyle() agora retorna ConsumerMapStyle em vez de Task<ConsumerMapStyle>.

  • PolylineStyle.setZIndex() foi adicionado.

Correções de bugs

  • A animação de trajeto agora acontece apenas quando o segmento de trajeto está sincronizado, resultando em uma experiência do usuário melhor.

  • O veículo "oscilando" corrigido durante a interpolação da animação quando o driver as atualizações de localização estão próximas.

  • Correção de um bug em que o veículo começa na cabeça da rota em vez de no local mais atualizado quando o monitoramento de viagem começa no meio de uma viagem ativa.

  • Mostrar a polilinha do trajeto ativo acima do trajeto restante quando se sobreponham.

Melhorias

  • Agora, exponha a classe Status do gRPC com métodos não ofuscados.

v0.5.1.01 (17 de maio de 2019)

Novos recursos

  • Suporte consecutivo para o Compartilhamento de jornada.

Mudanças na API

  • Nova classe ConsumerController.

PolylineType

Valor antigo Novo valor
TRIP_PREVIEW_AUTO_ROUTE PREVIEW_AUTO_ROUTE
TRIP_PREVIEW_TAXI_ROUTE PREVIEW_TAXI_ROUTE
TRIP_PREVIEW_TRUCK_ROUTE PREVIEW_TRUCK_ROUTE
TRIP_PREVIEW_TWO_WHEELER_ROUTE PREVIEW_TWO_WHEELER_ROUTE
TRIP_ROUTE ACTIVE_ROUTE
REMAINING_ROUTE

ConsumerTripCallback

Valor antigo Novo valor
onTripRouteUpdated onTripActiveRouteUpdated
onTripRemainingDistanceUpdated onTripActiveRouteRemainingDistanceUpdated
onTripRemainingWaypointsUpdated()

ConsumerController

  • Agora é possível definir callbacks para estados sem entrar no estado.
Método Chamada de retorno
startPickupSelection setPickupSelectionCallback
startDropoffSelection setDropoffSelectionCallback
startTripPreview setTripPreviewSelectionCallback
  • ConsumerController.setLanguage(String languageCode) permite definir o idioma usado nas chamadas do FleetEngine, por exemplo, para descrições de pontos de retirada.

Melhorias

  • O estado de seleção do descarte agora tem um pino arrastável.
  • A animação da câmera foi removida no estado INITIALIZE.
  • A ManagedChannelBuilder foi substituída pela AndroidChannelBuilder