Consumer SDK for iOS 版本说明

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

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 月）

改动

• 支持驱动程序 SDK 和消费者 SDK 兼容性，以便它们可以在同一应用中构建。
• 支持 Swift Package Manager，适用于 Driver 和 Consumer SDK。

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 年第二季度起发布的 iOS 版 Consumer SDK 版本将支持最低 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 日）

改动

• 移除了终端点服务，其中包括：

  • 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 日）

内部 bug 修复。

v1.0（2021 年 12 月 7 日）

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

API 变更

身份验证方面的更改

• 对于每个 gRPC，SDK 都会针对 AuthTokenFactory 接口的实现调用 getToken()。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 日

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

iOS 版 Consumer SDK 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

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

• 更新了 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;

改进

• 当列表中第一个途经点的 ETA 发生变化时，更新所有剩余途经点的 ETA。

• 强制在司机到达上车点时使相机自动居中。

• 在行程预订完毕后，但在任何匹配车辆位置可用之前，地图的镜头边界将同时包含上车地点和下车地点。

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 存在的问题。