按需约车和送货解决方案目前仅面向特定合作伙伴提供。如需了解详情，请与销售人员联系。

此页面由 Cloud Translation API 翻译。

Consumer SDK for Android 版本说明

本部分包含 Android 版消费者 SDK 的版本说明。

2.2.0（2024 年 5 月 7 日）

API 变更

添加了对 Jetpack Compose 集成的支持 API。这是一项实验性功能功能。如需详细了解如何与 Jetpack Compose 集成，请联系您的代表。

2.1.0（2024 年 1 月 17 日）

bug 修复

修复了 SDK 在应用生命周期

API 变更

引入了检索由 SDK 创建的 GoogleMap 实例的方法 (ConsumerGoogleMap.getGoogleMap()).
引入了 API 来检索由 SDK 创建的 Marker 实例，代表车辆 (ConsumerController.getConsumerMarker())。
引入 API，以接收客户端投影的时间和距离更新（ProjectedRouteEta）期间。

1.99.2（2023 年 11 月 3 日）

修复了从远程进程初始化 SDK 时发生崩溃的问题，与应用分离
修复了执行相机动画且没有相机动画时发生的崩溃问题留有足够的垂直或水平空间作为内边距。这仅适用于最新版地图渲染程序。
修复了导致背靠背行程的第一段被剪掉的 bug 当第二段路程经过相同路段时触发。

问题

在某个 API 被调用时，ConsumerApi.initialize() 会抛出异常实例已存在。要解决此问题，请先调用 ConsumerApi.getInstance() 并评估返回的 Task，以确定 API 实例已存在。

2.0.0（2023 年 9 月 15 日）

通知：重大更改

最低 API 级别要求已从 21 更新为 23。
将 Maps SDK 版本要求从 v17.0.0 更新为 v18.1.0
Kotlin 标准库的最低版本要求已从 v1.6.10 更新到 v1.9.0
更新 Google Play 服务依赖项版本
- 最低 play-services-base 库版本要求从 v18.0.1 到 v18.2.0
- 更新了 play-services-basement 库的最低版本要求从 v18.0.0 到 v18.2.0
- 更新了 play-services-location 库的最低版本要求从 v17.0.0 到 v21.0.1
- 最低 play-services-tasks 库版本要求从 v18.0.1 到 v18.0.2
添加了 androidx.room:room-runtime 库，并设置了最低版本要求到 v2.5.2
更新以下依赖项版本
- 最低 android-maps-utils 库版本要求从 v0.4.2 到 v3.5.2
- com.google.android.datatransport:transport-backend-cct 最低版本要求已从 v3.0.0 更新为 v3.1.9
- com.google.android.datatransport:transport-runtime 最低版本要求已从 v3.0.1 更新为 v3.1.9
- 最低 androidx.lifecycle:lifecycle-extensions 版本要求为已从 v2.0.0 更新为 v2.2.0
- 最低 androidx.Lifecycle:lifecycle-common-java8 版本要求为已从 v2.0.0 更新为 v2.6.1
- 最低 androidx.appcompat:appcompat 版本要求已从 v1.0.0 到 v1.6.1
- 最低 androidx.fragment:fragment 版本要求从以下日期更新： v1.0.0 到 v1.6.1
移除了以下先前已废弃的 API：ConsumerTrip、 ConsumerTripCallback、ConsumerTripManager、ConsumerTripOptions。他们已替换为 TripModel、TripModelCallback、TripModelManager 和 TripModelOptions。
使用消费者 SDK 的应用现在必须 targetSdkVersion（API 31 或更高级别）、compileSdkVersion（API 33 或更高）或。
使用消费者 SDK 的应用现在必须启用 Java 8 库支持。请参阅 https://developer.android.com/studio/write/java8-support 提供了更新。
使用 Proguard 或 Dexguard 的应用必须迁移到 R8。请参阅如需了解详情，请访问 https://developer.android.com/build/ProGuard-code。
使用消费者 SDK 的应用必须启用脱糖。请参阅 https://developer.android.com/studio/write/java8-support#library-desugaring 了解相关说明。
现在，如果正在发生以下情况，ConsumerApi.initialize() 方法会抛出异常：在创建 API 实例时调用。Task 回归由 ConsumerApi.getInstance() 用于确定是否存在实例

通知：API 弃用

废弃了 Trip.TripStatus 和 Trip.TripType 注解类，添加了要替换的 TripInfo.TripStatus 和 TripInfo.TripType 注解类。
- 受此变化影响 TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status) 已弃用，添加了 TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status) 以替换它。
- 在进行这项更改后，TripInfo#getTripStatus() 已被弃用，添加了 TripInfo#getCurrentTripStatus() 以替换它。
- 在进行这项更改后，TripInfo#getTripType() 已被弃用，添加了 TripInfo#getCurrentTripType() 以替换它。
废弃了 Trip 类。

其他变更和 bug 修复

支持请求最新版 Maps SDK 渲染程序。请参阅新版地图渲染程序了解详情。
提供从 v18.1.0（含）到的 Maps SDK 范围支持 v19.0.0（独占）版本。
修复“已超出截止日期”SDK 和 Google 后端。
修复了小尺寸屏幕和画中画模式下的呈现问题。

迁移指南

适用于 Android 消费者 SDK v2.0.0 的迁移

1.99.1（2023 年 8 月 31 日）

bug 修复

修复了在 SDK 宿主 activity 或 fragment 被销毁时发生崩溃的问题。
修复了 MapView 的尺寸为 0（高度或宽度）。
修复了在路线上投影车辆位置时发生崩溃的问题多段线

改进

防止 SDK 在主应用旁加载时崩溃，以及默认视觉资源不存在。

1.99.0（2023 年 6 月 22 日）

bug 修复

修复了小尺寸屏幕和画中画模式下的呈现问题。
修复了行程分享期间车辆闪烁的问题。

1.2.1（2023 年 6 月 7 日）

bug 修复

修复了导致车辆在行程分享期间闪烁的 bug。

1.2.0（2022 年 11 月 21 日）

bug 修复

修复了导致在 onTripActiveRouteTrafficUpdated 回调。

新功能

"路况感知型多段线"现已推出正式版。

1.1.2（2022 年 10 月 27 日）

bug 修复

解决了导致路线多段线在针对 TripModel 多次启动了 JourneySharingSession。

通知：冻结对 Android 5 的支持（2022 年 7 月 25 日）

对于 v1.1.1 SDK 版本，我们为在 Android 5 上运行的应用（对于 API 级别 21 和 22）。

这意味着：

您的 Android 应用上运行的消费者 SDK 至少支持 Android 5 （API 级别 21）的截止日期为 2023 年 6 月 30 日。
2023 年 6 月 30 日之后，我们将仅支持 Android API 级别 23 及更高级别。也就是说，我们将停止支持 Android API 级别 21 和 22，所有 SDK 版本。这意味着，与 Android 21 相关的 bug 或 22 的任何 SDK 版本（包括 4.x）均不会被修复，来保证 SDK 正常运行

v1.1.1（2022 年 7 月 25 日）

依赖项更改

将支持的最低 Android API 级别降级到 21。

v1.1.0（2022 年 4 月 28 日）

内部改进。

v1.0.19（2022 年 3 月 17 日）

bug 修复

修复了 ConsumerApi 类中的内存泄漏问题。

v1.0.14（2021 年 11 月 30 日）

现在，支持的最低 Android API 级别为 23。

API 变更

对 ConsumerTrip 和 ConsumerTripManager 类进行了更改。
- 清理了一些方法名称，使其含义更清晰，支持 iOS 平台
对 ConsumerTripCallback、ConsumerTrip 和 TripInfo 的更改。
- 更改了一些类名称，以便与 iOS 等效。上市时间要弃用的 TripModel、TirpModelManager 和 TripModelOptions ConsumerTrip、ConsumerTripManager 和 ConsumerTripOptions。
- 清理了一些方法名称。修改了或添加了 JavaDoc 评论方法传递更清晰的含义。
- 改进了错误处理方式。

样式自定义

已弃用的旧版封装容器
- 废弃了 MarkerStyleOptions 和 PolylineStyleOptions，取而代之的是两者共享的“MarkerOptions”和“PolylineOptions” 集成了 Google Maps SDK

崩溃监控

添加了崩溃检测和日志记录。
- 新增了一项允许您选择停用该功能。这个这项措施是全网范围更大规模的车祸监控措施之一。

身份验证更改

从 Authentication 界面中移除了不必要的方法。
- 移除了 ServiceType 参数。

v0.9.28（2021 年 5 月 18 日）

API 变更

更新了所有 ConsumerTripCallback 方法，以将 TripInfo 用作参数。
添加了 ConsumerTrip.isRefreshing()，用于指示 ConsumerTrip 正在使用来自 Fleet Engine 的最新行程信息进行自我更新。
添加了 ConsumerTripCallback.onTripRemainingRouteDistanceUpdated()。
添加了 ConsumerTripCallback.onTripRemainingRouteUpdated()。
将 Guava 返回值类型（ImmutableSet、ImmutableList）替换为 java.util 等效类。
软件包名称变更：
- 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
```

实现方面的变更

修复了在与使用。
SDK 不再包含未经混淆处理的 io.grpc 副本。
修复了某些设备上路况多段线闪烁的 bug。路况现在，细分的结尾将变为圆角。

v0.9.15（2020 年 10 月 7 日）

API 变更

此版本引入了流量感知功能多段线。 - 添加了TripInfo.getActiveRouteTraffic() 和 TripInfo.getRemainingRouteTraffic()。
- 添加了 ConsumerTripCallback.onTripActiveRouteTrafficUpdated() 和 ConsumerTripCallback.onTripRemainingRouteTrafficUpdated()，用于指示在流量发生变化时触发
- 添加了用于流量自定义的 PolylineStyleOptions （setTrafficEnabled()、setTrafficColorNoData()、 setTrafficColorNormal()、setTrafficColorSlow()、 setTrafficColorTrafficJam()）。
- 公开了 PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION。
- 添加了 TripWaypoint.getTrafficData()。
- 添加了 TrafficData 数据类型。
- 添加了 ConsumerController.hideAllSessions()。 ConsumerController.showSession() 不再接受 null 作为参数。

v0.9.9（2020 年 7 月 15 日）

API 变更

这是一项重大变更，引入了一个模块化架构，具有（例如， ConsumerTripManager）和界面层（例如， JourneySharingSession）。有关如何迁移到新版请参阅模块化迁移指南。 - ConsumerTrip 对象现在数据来源 ConsumerTripManager.getTrip()。
- ConsumerTrip.unregisterCallback 已重命名为 ConsumerTrip.unregisterTripCallback。
- ConsumerTrip.isCallbackRegistered 已重命名为 ConsumerTrip.isTripCallbackRegistered。
- 添加了 ConsumerTrip.setConsumerTripOptions() 和 ConsumerTrip.getConsumerTripOptions()。
- 移除了 ConsumerTrip.setAutoRefreshInterval()。
移除了非行程共享 API。
- 移除了车辆密度地图。
- 已移除行程预览状态。
- 移除了上车点选择状态。
- 移除了下车点选择状态。
- 移除了以下标记类型：SELECTED_PICKUP_POINT、 SUGGESTED_PICKUP_POINT、HIGHLIGHTED_PICKUP_POINT和 SELECTED_DROPOFF_POINT。
OnConsumerMarkerClickCallback 和 ConsumerMapReadyCallback 已从抽象类之间的接口
添加了 ConsumerController.getCameraUpdate()， ConsumerController.isAutoCameraEnabled()和 ConsumerController.enableAutoCamera()。
移除了自定义 FAB 及其关联的方法（ConsumerController.isMyLocationFabEnabled 和 ConsumerController.setMyLocationFabEnabled）。

实现方面的变更

ConsumerTripCallback（无论是否使用 LifecycleOwner，不再自动取消注册 TripStatus.COMPLETE 或 TripStatus.CANCELED。
AutoCamera 现在默认处于启用状态，永远不会重新启用或自行停用。以前，系统会自动在 TripStatus.ARRIVED_AT_PICKUP，并在用户互动时自行停用与地图共享旅程。
对行程共享车辆做出了以下改进动画：
- 行程分享动画现在可处理车辆可能沿着已经遍历的路线合法地返回。
- 现在，车辆会以直线动画代替路线通过在算法确定适当的选择。
不再需要 FINE_LOCATION 权限。

其他变更

更新了以下依赖项版本：
- 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（2020 年 3 月 23 日）

API 变更

添加了 TripInfo.getVehicleId()、TripInfo.getNumberOfPassengers()、 TripInfo.getIntermediateDestinationIndex(), TripInfo.getTripActiveRoute() 和 TripInfo.getTripRemainingRoute()。
添加了在 ConsumerApi 初始化期间使用的 options 类，可让要动态设置的 FleetEngine 地址。如果未使用 FleetEngine 值，它会尝试从 Android 清单或否则将恢复为默认值。

改进

当行程状态为 ARRIVED_AT_PICKUP。
改进了偏离路线的车辆跟踪功能（需要 DriverSDK 1.15）：
- 当车辆抵达路线时，车辆跟踪功能不会将车辆与路线匹配驶过上车点。
- 借助车辆跟踪功能，您可以显示车辆正在上路行驶；用于示例。
现在，当驾驶员的目标页面不匹配时，车辆图标会更新 Fleet Engine 中的目标位置。

v0.8.6（2019 年 12 月 16 日）

API 变更

添加了 TripInfo.getVehicleLocation()。
“ConsumerMapView”已不再是最终版本。

实现方面的变更

现在使用服务器距离计算活动路程剩余距离（驾驶员报告 + 静态路由，如果适用），而不是本地贴靠。此更改可产生更准确的剩余距离值。

其他变更

需要新的依赖项。如需了解详情，请参阅 .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
添加了行程请求延迟时间日志。
添加了行程响应错误日志。

备注

从版本 0.8.1 开始，面向 Android 的消费者 SDK 以 Jetified zip 格式提供归档。如需了解如何对其进行反 Jetify 处理，请参阅 Jetifier: Reverse 模式。

v0.8.1（2019 年 9 月 13 日）

新功能

支持 ConsumerMapView.
ODRD 工件现在以 Maven 代码库（而不是 .aar zip 文件）的形式提供。有关详情，请参阅将使用方 SDK 添加到您的 app。

API 变更

添加了 ConsumerController.disableAutoCamera() 作为 centerMapForState()。
VehicleLocation.getUpdateTime() 现在会返回一个 Long，它表示时间戳（以毫秒为单位）。
简化了 AuthTokenFactory 接口，以针对词元生成。将 AuthTokenFactory 从接口更改为了抽象类来实现 Java7 中的向后兼容性。此次变更向后兼容，但用于生成单服务令牌的旧方法已被弃用，最终将被移除。

实现方面的变更

现在，资源居中于图标中心，从而消除了阴影偏移。
无需等待即可获得 setState到JOURNEY_SHARING onStartTripMonitoring() 了解受监控的行程状态。
始终返回首次行程数据更新的数据，即使行程数据已失效同步。
添加了 Android 地图实用程序作为提供的依赖项。

bug 修复

修复了 grpc keep 的受损 ProGuard 导出语法。

v0.7.0（2019 年 8 月 7 日）

新功能

“旅程分享”功能的多目的地支持。

API 变更

新增了 ConsumerTripCallback 方法。
- onTripIntermediateDestinationsUpdated()。
- onTripETAToNextTripWaypointUpdated()。
新增了 ConsumerController 方法。
- getIntermediateDestinations()。
- setIntermediateDestinations(List<TerminalLocation> intermediateDestinations)。
新建 TripStatuses。
- TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION。
- TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION。
新增了 TripWaypoint getter。
- getETAMillis()。
- getDistanceMeters()。
添加了 TripInfo 类。
- 您可以使用以下代码获取正在进行的行程的 TripInfo ConsumerTripManager.getActiveTripInfo()。
添加了 WaypointType.INTERMEDIATE_DESTINATION。
添加了 MarkerType.TRIP_INTERMEDIATE_DESTINATION。
已根据合并的“ConsumerMapStates”创建“ConsumerMapState.JOURNEY_SHARING” ENROUTE_TO_PICKUP、ARRIVED_AT_PICKUP、ENROUTE_TO_DROPOFF和 COMPLETE。
- “StateChangeCallbacks”已更新。
- 添加了 onStateJourneySharing()。
- 已移除onStateWaitingForPickup()、onStateDriverArrived()、 onStateEnroute()和onStateEndofTrip()。

bug 修复

修复了行程时路线未剪辑到车辆位置的 bug 监测在进行中的行程期间（而不是路线起点）开始。
修复了以下 bug：不为上面注册的监听器调用行程回调在 TripManager 提取行程数据之后将 Tripmanager。
相机缩放现在仅包含有效路线和下一个行程航点（属于该行程的航点）。即使只剩下一条腿缩放都不会包含该元素。之前，下车点已包含在内当车辆正在前往上车点或已抵达上车点时放大显示上车点。如今，情况不再如此。

改进

使用驾驶员数据填充第 0 个剩余航点（其余航点）列表是从 ConsumerTripCallback.onTripRemainingWaypointsUpdated 返回的和TripInfo.getRemainingWaypoints()。
当 ETA 更新为第一个航点时，更新所有剩余的航点 ETA 列表更改。
仅当司机到达上车点时，才能强制重新启用自动摄像头。以前，对于每次行程状态变化，autocamera 将重置为启用。“自动相机”现为但仍然默认处于启用状态如果有新的有效行程，自动相机不会重新启用设置时没有对 startTripMonitoring() 进行新的调用。

v0.6.1（2019 年 6 月 26 日）

新功能

拼车支持行程分享。

API 变更

ConsumerController.getConsumerMapStyle() 现在会返回 ConsumerMapStyle 而非 Task<ConsumerMapStyle>。
添加了 PolylineStyle.setZIndex()。

bug 修复

现在，仅当路线路段同步时，才会触发路线动画从而改善用户体验
修复了车辆“闪烁”问题在动画插值期间位置更新相距不远。
修复了以下 bug：车辆从路线起点，而不是在当行程监控在进行中的行程。
显示有效路线多段线时，在剩余路线上方重叠。

改进

现在，使用未混淆的方法公开 gRPC Status 类。

v0.5.1.01（2019 年 5 月 17 日）

新功能

为“旅程分享”提供背靠支持。

API 变更

新增了 ConsumerController 类。

PolylineType

旧值	新值
`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

旧值	新值
`onTripRouteUpdated`	`onTripActiveRouteUpdated`
`onTripRemainingDistanceUpdated`	`onTripActiveRouteRemainingDistanceUpdated`
	`onTripRemainingWaypointsUpdated()`

ConsumerController

现在，您无需进入状态即可为状态设置回调。

方法	回拨电话
`startPickupSelection`	`setPickupSelectionCallback`
`startDropoffSelection`	`setDropoffSelectionCallback`
`startTripPreview`	`setTripPreviewSelectionCallback`

ConsumerController.setLanguage(String languageCode) 可用于设置 FleetEngine 通话中使用的语言（用于示例）。

改进

下车点选择状态现在有一个可拖动图钉。
移除了 INITIALIZE 状态下的相机动画。
已将“ManagedChannelBuilder”替换为“AndroidChannelBuilder”。