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

此页面由 Cloud Translation API 翻译。

Consumer SDK for Android 版本说明

本部分包含 Consumer SDK for Android 的版本说明。

2.1.0（2024 年 1 月 17 日）

bug 修复

修复了在整个应用生命周期内多次初始化 SDK 时发生的崩溃问题。

API 变更

引入了用于检索 SDK 创建的 GoogleMap 实例的方法 (ConsumerGoogleMap.getGoogleMap())。
引入了用于检索 SDK 创建的 Marker 实例以表示车辆的 API (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
添加了最低版本要求设置为 v2.5.2 的 androidx.room:room-runtime 库
更新以下依赖项版本
- 最低 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 取代。
现在，使用 Consumer SDK 的 targetSdkVersion 必须为 API 31 或更高级别，compileSdkVersion 必须为 API 33 或更高级别。
使用 Consumer SDK 的应用现在必须启用 Java 8 库支持。如需查看更新说明，请参阅 https://developer.android.com/studio/write/java8-support。
使用 Proguard 或 Dexguard 的应用必须迁移到 R8。如需了解详情，请参阅 https://developer.android.com/build/shrink-code。
使用消费者 SDK 的应用必须启用脱糖。如需了解相关说明，请参阅 https://developer.android.com/studio/write/java8-support#library-desugaring。
现在，如果在已创建 API 实例时调用 ConsumerApi.initialize() 方法，则会抛出异常。必须使用 ConsumerApi.getInstance() 返回的 Task 来确定事先是否有 API 实例。

通知：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 类。

其他更改和问题修复

支持请求最新版 Maps SDK 渲染程序。如需了解详情，请参阅新版地图渲染程序。
提供从 v18.1.0（含）到 v19.0.0（不含）版本的 Maps SDK 范围支持。
修复了 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 回调中报告空流量的 bug。

新功能

“路况感知多段线”现已正式发布。

1.1.2（2022 年 10 月 27 日）

bug 修复

解决了在针对 TripModel 多次启动 JourneySharingSession 后导致路线多段线消失的 bug。

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

对于 v1.1.1 SDK 版本，我们为在 Android 5 上运行的应用延长了一年的支持期（API 级别为 21 和 22）。

这意味着：

在 2023 年 6 月 30 日之前，您的 Android 应用上运行的消费者 SDK 将至少支持 Android 5（API 级别 21）。
2023 年 6 月 30 日之后，我们将仅支持 Android API 级别 23 及更高级别。也就是说，在该日期之后，我们将停止在所有 SDK 版本中支持 Android API 级别 21 和 22。这意味着，在任何 SDK 版本（包括 4.x）中，与 Android 21 或 22 相关的 bug 都将无法修复，我们也无法保证这些 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，这两者均与 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.library.ridesharing.common.AuthTokenContext -> com.google.android.credentials.ridesharing.consumer.auth.AuthTokenContext
- com.google.android.library.ridesharing.common.AuthTokenFactory -> com.google.android.library.ridesharing.consumer.auth.AuthTokenFactory
- com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.library.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.library.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 可能会在准备就绪之前因与地图的互动而崩溃。
SDK 不再包含未经过混淆处理的 io.grpc 副本。
修复了某些设备上路况多段线闪烁的问题。流量细分现在将采用圆角两端。

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）之间的关系更清晰。如需了解如何迁移到新架构，请参阅模块化迁移指南。- 现在可以从 ConsumerTripManager.getTrip() 获取 ConsumerTrip 对象。
- 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 现在默认处于启用状态，且一律不会重新启用或停用自身。以前，当用户在行程共享期间与地图互动时，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 值调用该 API，它会尝试从 Android 清单获取它，否则会回退到默认值。

改进

当行程状态为 ARRIVED_AT_PICKUP 时，系统不会显示路线多段线。
离线车辆跟踪功能已得到改进（需要 Driver SDK 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 的 Consumer SDK 以 Jetified zip 归档文件的形式提供。如需了解如何对它进行去 Jetifier，请参阅 Jetifier：反向模式。

v0.8.1（2019 年 9 月 13 日）

新功能

支持 ConsumerMapView。
ODRD 工件现在包含在 Maven 制品库中，而不是 .aar zip 文件。如需了解详情，请参阅将 Consumer SDK 添加到您的应用。

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 类。
- 您可以使用 ConsumerTripManager.getActiveTripInfo() 获取有效行程的 TripInfo。
添加了 WaypointType.INTERMEDIATE_DESTINATION。
添加了 MarkerType.TRIP_INTERMEDIATE_DESTINATION。
通过合并的 ConsumerMapStates ENROUTE_TO_PICKUP、ARRIVED_AT_PICKUP、ENROUTE_TO_DROPOFF 和 COMPLETE 创建了 ConsumerMapState.JOURNEY_SHARING。
- “StateChangeCallbacks”已更新。
- 添加了 onStateJourneySharing()。
- 移除了 onStateWaitingForPickup()、onStateDriverArrived()、onStateEnroute() 和 onStateEndofTrip()。

bug 修复

修复了以下 bug：行程监控在进行中的行程中间（而非在路线前方）开始时，系统不会将路线剪裁为车辆位置。
修复了以下 bug：在 TripManager 获取行程数据后，不针对在 Tripmanager 上注册的监听器调用行程回调。
现在，相机缩放仅包括有效路线和下一个行程航点（属于行程的航点）。即使剩下的桌腿可见，缩放也不会将其包含在内。以前，当车辆正在上车点或已到达上车点时，下车点会包含在缩放级别中。现在已经不一样了。

改进

使用驱动程序数据填充剩下的第 0 个航点（其余航点列表通过 ConsumerTripCallback.onTripRemainingWaypointsUpdated 和 TripInfo.getRemainingWaypoints() 返回）。
当列表中第一个航点的预计到达时间发生变化时，更新所有剩余的航点预计到达时间。
仅在司机抵达上车点时强制重新启用自动摄像头。以前，每当行程状态发生变化时，自动相机都会重置为启用状态。默认情况下，相机仍处于启用状态。如果在没有重新调用 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。