Consumer SDK for iOS 版本说明

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

v11.1.0（2026 年 9 月）

• 11.1.0 版本的版本升级。
• 修复了一些次要 bug 并更新了内部依赖项。

v10.10.1（2026 年 5 月）

• [问题修复] 修复了以下回归问题：如果响应中缺少特定字段，行程更新可能会失败。

v10.10（2026 年 3 月）

• [问题修复] 进行了更改，以便在行程期间发生网络中断时，ConsumerSDK 能够更快地恢复。
• Consumer SDK 是使用 Xcode 26 构建的。

v10.0.0（2025 年 6 月）

已更改

• 对 iOS 15 的支持现已冻结。最低 iOS 版本现为 16.0。

API 变更

• 添加了 GMTSVehicleLocationOptions 类，您可以使用 serverTime 属性确定 Fleet Engine 收到最新位置信息更新的时间。
• 在 GMTSVehicleLocation 中添加 initWithOptions<GMTSVehicleLocationOptions> 初始化程序
• 废弃了 GMTSVehicleLocation 中的 initWithLatLng:GMTSLatLng 初始化程序。请改用 initWithOptions:<GMTSVehicleLocationOptions> 初始化程序。

v9.2.1（2025 年 4 月）

已更改

• 修复了未定义符号错误。

v9.2（2025 年 1 月）

已更改

• 版本从 9.0 升级到 9.2。
• 支持云端地图样式设置。
• 支持用户在行程中检索“车辆位置”状态。
• 修复了多段线消失的罕见问题。

v9.0（2024 年 7 月）

已更改

• 支持 Geo iOS SDK v9.0。
• 对 iOS 14 的支持现已冻结。最低 iOS 版本现为 15.0。
• 此版本包含 .xcprivacy 文件，以支持 Apple 隐私清单。
• 包含针对一种罕见的日志相关崩溃问题的潜在修复。

v3.3.0（2024 年 3 月）

已更改

• 支持 Driver SDK 和 Consumer SDK 兼容性，以便在同一应用中构建。
• 支持适用于 Driver SDK 和 Consumer SDK 的 Swift Package Manager。

v3.2.0（2023 年 12 月）

已更改

• 问题修复和文档更新。

已弃用

• 废弃了 GMTCMapView 中的 [GMTCMapView initWithCoder]。

v3.1.1（2023 年 10 月）

已更改

• 修复了未调用 GMSMapViewDelegate 方法的 bug。

v3.1.0（2023 年 9 月）

已更改

• 适用于 Consumer SDK 的 CocoaPod 现在是一个 .xcframework，支持在基于 Intel 和 Apple Silicon 的 Mac 上为开发者提供设备和模拟器 build。

v3.0.1（2023 年 8 月）

已更改

• 修复了未定义符号错误。

v3.0.0（2023 年 5 月）

已更改

• 移除了 GMTCMapView 中已废弃的初始化程序。
• 修复了从 GMTCTripModel 中移除所有订阅者后仍继续提取身份验证令牌的问题。
• 对 iOS 13 的支持现已冻结。现在，最低 iOS 版本为 14.0。
• 新的支持的最低 Xcode 版本为 14.0。 请注意 Xcode 14 版本说明中有关停止支持使用 bitcode 进行构建的弃用声明。
• 根据移动操作系统版本支持政策，自 Consumer SDK for iOS v3.0.0 起，我们将冻结对 iOS 13 的支持。现在支持的最低操作系统版本是 iOS 14。旧版 SDK 将继续支持 iOS 13。如果您的依赖项未指定版本号，您的 IDE 将加载最新的 SDK 版本，并且应用的新 build 将不支持 iOS 13。在应用的 build 依赖项中为 Consumer SDK for iOS 指定版本，以便控制何时提高新版应用的最低支持操作系统。

通知

停止支持 iOS 14 - 2023 年 5 月 15 日

根据移动操作系统版本支持政策，我们将在即将推出的 Consumer SDK for iOS 主要版本中冻结对 iOS 14 的支持。

自 2024 年第二季度起发布的 Consumer SDK for iOS 版本将至少支持 iOS 15。旧版 SDK 将继续支持 iOS 14。

如果您的依赖项未指定版本号，您的 IDE 将加载最新的 SDK 版本，并且应用的新 build 将不支持 iOS 14。

在应用的 build 依赖项中为 Consumer SDK for iOS 指定版本，以便控制何时提高新版应用的最低支持操作系统。

v2.2.0（2023 年 2 月）

已更改

• 将头文件中的条款及条件网址更新为正确的链接，并修复了其他一些标点符号方面的小问题。
• 修复了文档中的各种拼写、标点和其他细微错误。

v2.1.0（2022 年 9 月 12 日）

已更改

• 问题修复和文档更新。

v2.0.0（2022 年 7 月 18 日）

已更改

• 移除了 Terminal Point Service，其中包括：

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

• 对 iOS 12 的支持现已冻结。最低 iOS 版本现为 13.0。

已弃用

• 弃用了公共类 GMTCMapView 中的初始化程序。

通知

在 2023 年 Consumer iOS SDK 的主要版本更新中，我们将冻结对 iOS 13 的支持（弃用）。自 2023 年 6 月起，支持的最低 iOS 版本将为 iOS 14。客户应做好准备，在更新之前更改其代码中的最低版本支持标志。

v1.0.6（2022 年 3 月 24 日）

内部问题修复。

v1.0（2021 年 12 月 7 日）

此版本支持的最低 iOS 版本为 12.0。

API 变更

身份验证变更

• SDK 会针对每个 gRPC 调用 getToken()，以实现 AuthTokenFactory 接口。SDK 通过拦截对 Fleet Engine 的调用，然后将从 getToken() 返回的 JWT 附加到 HTTP 授权标头来实现此目的。请注意，您需要自行生成有效令牌。即未过期且具有适当声明的令牌。

• 已将 GMTSAuthorization 更改为 GMTCAuthorization。

• 移除了 GMTSServiceType。

行程信息和回调变更

• 更新了行程属性名称：remainingDistanceOfActiveRouteInMeters。

• GMTCTripModelSubscriber 中新增了流量数据更新。

• 添加了属性 remainingDistanceOfCurrentRouteInMeters。

• 向 GMTSTripPropertyFields 添加了新属性：

  • GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters。
  • GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute。
  • GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute。
  • GMTSTripPropertyFieldRemainingRouteTraffic。

• 在 GMTSTrip 中添加了新属性 remainingDistanceOfActiveRouteInMeters 和 distanceOfRemainingRouteInMeters。

• RegisterSubscriber现在会自动为tripModel启动行程监控。当没有更多订阅者时，UnregisterSubscriber 将停止监控。ModelState 和 ModelOptions 已分别重命名为 state 和 options。从公共头文件中移除了 stop 和 start。

  • 将 modelState 重命名为了 state。
  • 将 modelOptions 重命名为了 options。
  • 移除了 TripModel 中的 start() 和 stop()。

其他 API 变更

• 移除了 GMTSTripPreview 和 GMTSTripPreviewVehicleOptions。

• 移除了自提点选择服务，其中包括：

  • GMTSPickupPointArea。
  • GMTSPickupPointGroup。
  • GMTSPickupPointMatch。

冻结对 iOS 12 的支持 - 2021 年 10 月 18 日

为了应对内部依赖项的变化，我们将在即将推出的 iOS 版 Consumer SDK 主要版本中冻结对 iOS 12 的支持。

Consumer SDK for iOS v2.0 或更高版本仅支持搭载 iOS 13 或更高版本的设备。旧版 SDK 将继续支持 iOS 12。

如果 CocoaPods 或 Carthage 中的依赖项未指定版本号，Xcode 将加载最新版本，并且应用的新 build 将不支持 iOS 12。

请务必在应用的 build 依赖项中指定版本，以便控制何时提高新版应用的最低支持操作系统。如需查看指定版本的示例，请参阅 Maps SDK for iOS 文档。 请参阅应用维护最佳实践指南。

v0.11.0（2021 年 9 月 30 日）

变更

• 添加了 SDK 初始化期间的崩溃检测功能。您还可以选择在 GMTCServices 上使用 setAbnormalTerminationReportingEnabled: API 停用此功能。

API 变更

更新了所有类的名称前缀：

• GRC -> GMTC，例如 GRCMapView -> GMTCMapView。
• GRS -> GMTS，例如 GRSTrip -> GMTSTrip。

GMTSAuthorization API 已更新

• 添加了新键 kGMTSAuthorizationContextKeyTaskID，用于在调用 fetchAuthTokenForServiceType:authorizationContext:completion: 时在 authorizationContext 中指定任务 ID。

• GMTSServiceType 枚举已更新：

  旧值	新值
  GMTSServiceTypeUnknown	GMTSServiceTypeUnspecified
  GMTSServiceTypeTripService
  GMTSServiceTypeVehicleService	GMTSServiceTypeVehicle
  GMTSServiceTypeTerminalPointService
  	GMTSServiceTypeTask

v0.10.0（2021 年 5 月 3 日）

变更

弃用了对 iOS 10.x 的支持。现在支持的最低 iOS 版本为 11.0。

API 变更

• 引入了 GRCMutableMarkerStyleOptions，以便更方便地自定义行程分享标记。

• 在 GRCTripModelSubscriber 协议中引入了 tripModel:didUpdateRemainingRoute: 和 tripModel:didUpdateRemainingRouteDistance:，用于在剩余路线或距离更新时进行行程更新回调。

v0.9.0（2021 年 1 月 25 日）

改进

• 此版本引入了路况感知多段线，用于行程分享。

API 变更

• 引入了 GRCMutablePolylineStyleOptions，用于自定义多段线，可用于为行程分享启用路况多段线渲染。
• 在 GRCTripModelSubscriber 中添加了路况数据更新回调：
  • tripModel:didUpdateActiveRouteTraffic:
• 引入了 GRSTrafficData。
• 在 GRSTripWaypoint 中添加了用于访问流量数据的新属性：
  • trafficData
• 在 GRSTrip 中添加了用于访问流量数据的新方法：
  • activeRouteTraffic
  • remainingRouteTraffic

v0.6.7（2020 年 3 月 23 日）

改进

• 行程状态为 ARRIVED_AT_PICKUP 时，系统不会显示路线多段线。
• 改进了偏离路线的车辆跟踪（需要 DriverSDK 1.15）：
  • 当车辆驶过上车点时，车辆跟踪不会将车辆贴靠到路线。
  • 车辆跟踪功能可显示车辆在道路之外的位置，例如在未映射的停车场中。
• 当司机的目的地与 Fleet Engine 中的目的地不一致时，车辆图标不再强制显示过时的路线。
• 现在，系统会舍弃过时的行程响应。

v0.6.3（2019 年 12 月 16 日）

变更

• 添加了行程请求延迟时间的日志。

• 添加了行程响应错误日志。

v0.5.4(86.0)（2019 年 8 月 7 日）

新功能

• 行程分享功能支持多个目的地。

API 变更

• GRSTripStatus 中添加了新的行程状态。

  • GRSTripStatusEnrouteToIntermediateDestination。
  • GRSTripStatusArrivedAtIntermediateDestination。

• GRSTrip 中添加了新属性。

  • intermediateDestinations。
  • intermediateDestinationIndex。

• 向 GRCTripServiceSubscriber 添加了新的回调 API。

  • - (void)tripService:(GRCTripService *)service didUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;

  • - (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;

• 向 GRCMapViewMarkerType 添加了新的标记类型枚举。

  • GRCMapViewMarkerTypeIntermediateDestination。

• 向 GRCCustomizableMarkerType 添加了新的可自定义标记类型枚举。

  • GRCCustomizableMarkerTypeIntermediateDestination

• GRCMapViewCustomerState 中添加了新的 mapViewCustomerState。

  • GRCMapViewCustomerStateJourneySharing

• 已从GRCMapViewCustomerState中删除 4 名mapViewCustomerState成员。

  • GRCMapViewCustomerStateWaitingForPickup
  • GRCMapViewCustomerStateArrivedAtPickup
  • GRCMapViewCustomerStateEnRoute
  • GRCMapViewCustomerStateEndOfTrip

• 从 GRCMapView 中删除了四个 mapView 回调 API。

  • -(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;
  • -(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;
  • -(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;
  • -(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;

• 向 GRCMapView 添加了新的回调 API。

  • - (void)mapViewDidStartJourneySharing:(GRCMapView *)mapView;

改进

• 当列表中第一个航点的预计到达时间发生变化时，更新所有剩余航点的预计到达时间。

• 在司机到达上车点时，强制镜头自动重新居中。

• 在行程预订后，以及任何匹配的车辆位置信息可用之前，摄像头边界将同时包含上车地点和下车地点。

v0.4.5(28.0)（2019 年 6 月 26 日）

新功能

• 支持拼车行程共享。

API 变更

• type 字段已从 GRSTerminalLocation 中移除。

问题修复

• 现在，只有在路线段同步时才会播放路线动画，从而改善用户体验。

• 修复了针对 GRCCustomizableMarkerTypeSelectedDropoffPoint 调用 API isMarkerStyleOptionsCustomizedForType: 始终返回 NO 的问题。

v0.4.3（2019 年 5 月 17 日）

新功能

• 为行程分享提供连续支持。
• 行程分享现在支持动态车辆位置报告速率。

API 变更

GRCMapViewMarkerType

旧值	新值
GRCMapViewMarkerTypeSelectedPickup	GRCMapViewMarkerTypeSelectedPickupPoint
GRCMapViewMarkerTypeSelectedDropoff	GRCMapViewMarkerTypeSelectedDropoffPoint
GRCMapViewMarkerTypePickupCandidate	GRCMapViewMarkerTypeSuggestedPickupPoint
	GRCMapViewMarkerTypeHighlightedPickupPoint
	GRCMapViewMarkerTypeTripPreviewPickupPoint
	GRCMapViewMarkerTypeTripPreviewDropoffPoint
	GRCMapViewMarkerTypeTripPickupPoint
	GRCMapViewMarkerTypeTripDropoffPoint

GRCMapView

旧值	新值
	redrawRidesharingOverlays

GRCTripServiceSubscriber 协议

旧值	新值
tripService:didUpdateTripRoute:	tripService:didUpdateActiveRoute:
tripService:didUpdateRemainingDistance	tripService:didUpdateActiveRouteRemainingDistance
	tripService:didUpdateRemainingWaypoints

GRCPolylineType

旧值	新值
GRCPolylineTypeTripRoute	GRCPolylineTypeActiveRoute
GRCPolylineTypeTripPreviewAutoRoute	GRCPolylineTypePreviewAutoRoute
GRCPolylineTypeTripPreviewTaxiRoute	GRCPolylineTypePreviewTaxiRoute
GRCPolylineTypeTripPreviewTruckRoute	GRCPolylineTypePreviewTruckRoute
GRCPolylineTypeTripPreviewTwoWheelerRoute	GRCPolylineTypePreviewTwoWheelerRoute
	GRCPolylineTypeRemainingRoute

GRCPolylineStyleOptions

旧值	新值
	zIndex

GRSTrip

旧值	新值
	remainingWaypoints 个房源
route 个房源
remainingDistanceInMeters 个房源
	GRSTripWaypoint

改进

• 减少了行程分享的网络消耗。
• 所选的候选接送点现已突出显示。
• 与 Maps SDK v3.1.0 兼容

问题修复

• 修复了标记在第二次点按时没有响应的问题。
• 修复了以下问题：在预订行程后，mapView 的相机边界有时会在开始时显示意外的视口。
• 修复了 SDK 版本 API 的问题。