Consumer SDK for iOS 版本说明

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

v9.0（2024 年 7 月）

改动

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

v3.3.0（2024 年 3 月）

改动

• 支持驱动程序和消费者 SDK 兼容性，因此可在同一应用中构建这两种 SDK。
• 支持适用于驱动程序 SDK 和使用方 SDK 的 Swift Package Manager。

v3.2.0（2023 年 12 月）

改动

• 修复了一些问题并更新了文档。

已弃用

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

v3.1.1（2023 年 10 月）

改动

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

v3.1.0（2023 年 9 月）

改动

• 面向消费者 SDK 的 CocoaPod 现在是一个 .xcframework，它同时支持基于 Intel 和 Apple Silicon 的 Mac 的开发者的设备 build 和模拟器 build。

v3.0.1（2023 年 8 月）

改动

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

v3.0.0（2023 年 5 月）

改动

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

通知

冻结对 iOS 14 的支持 - 2023 年 5 月 15 日

根据 Mobile OS 版本支持情况 政策，我们 在即将发布的 Consumer SDK 主要版本中冻结了对 iOS 14 的支持， iOS 版。

iOS 版消费者 SDK 版本将于 2024 年第二季度发布 将至少支持 iOS 15。早期的 SDK 版本将继续支持 iOS 14。

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

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

v2.2.0（2023 年 2 月）

改动

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

v2.1.0（2022 年 9 月 12 日）

改动

• 修复了一些问题并更新了文档。

v2.0.0（2022 年 7 月 18 日）

改动

• 移除了 Terminal Point 服务，该服务包括：

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

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

已弃用

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

通知

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

v1.0.6（2022 年 3 月 24 日）

修复了内部错误。

v1.0（2021 年 12 月 7 日）

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

API 变更

身份验证方面的变更

• 为每个 gRPC 实现 AuthTokenFactory 接口时，SDK 会调用 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 版消费者 SDK v2.0 或更高版本将仅支持运行 最低为 iOS 13。较低版本的 SDK 将继续支持 iOS 12。

如果 CocoaPods 或 Carthage 中的依赖项 Xcode 将加载其最新版本和新版本 您的应用将不支持 iOS 12。

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

v0.11.0（2021 年 9 月 30 日）

变更

• 添加了 SDK 初始化期间的崩溃检测。您还可以使用 setAbnormalTerminationReportingEnabled: GMTCServices 上的 API。

API 变更

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

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

更新了 GMTSAuthorization API

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

• GMTSServiceType 枚举已更新：

  旧值	新值
  GMTSServiceTypeUnknown	GMTSServiceTypeUnspecified
  GMTSServiceTypeTripService
  GMTSServiceTypeVehicleService	GMTSServiceTypeVehicle
  GMTSServiceTypeTerminalPointService
  	GMTSServiceTypeTask

v0.10.0（2021 年 5 月 3 日）

变更

不再支持 iOS 10.x。现在，支持的最低 iOS 版本是 11.0。

API 变更

• 上市时间 GRCMutableMarkerStyleOptions 更加便捷地自定义行程共享标记。

• 推出了 tripModel:didUpdateRemainingRoute: 和tripModel:didUpdateRemainingRouteDistance: GRCTripModelSubscriber协议 。

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）： <ph type="x-smartling-placeholder">
  </ph>
  • 车辆行驶时，车辆跟踪功能不会使车辆按路线行驶 超过上车点。
  • 借助车辆跟踪功能，您可以显示车辆正在上路行驶；例如 在未在地图上标识的停车场内停车。
• 当驾驶员的方向盘 目标与 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 中删除了 4 个 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 中移除。

bug 修复

• 现在，仅当路线路段同步时才会播放路线动画， 从而提升用户体验

• 修复了调用 API 时出现的问题 isMarkerStyleOptionsCustomizedForType:： GRCCustomizableMarkerTypeSelectedDropoffPoint 始终返回 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 兼容

bug 修复

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