此页面由 Cloud Translation API 翻译。

Consumer SDK for iOS 版本说明

本部分包含适用于 iOS 的 Consumer 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 的 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 版本说明中关于停止支持使用位码进行构建的废弃内容。
根据移动操作系统版本支持政策，自 iOS 版消费者 SDK v3.0.0 起，我们将停止支持 iOS 13。支持的最低操作系统版本已更新为 iOS 14。较低版本的 SDK 将继续支持 iOS 13。如果您的依赖项未指定版本号，IDE 将加载最新的 SDK 版本，而应用的新 build 将不支持 iOS 13。在应用的构建依赖项中指定 Consumer SDK for iOS 版本，以便控制何时提高应用新版本支持的最低操作系统版本。

通知

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

根据移动操作系统版本支持政策，我们将在即将发布的 iOS 版 Consumer SDK 主要版本中停止支持 iOS 14。

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

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

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

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 实现 AuthTokenFactory 接口时，SDK 会调用 getToken()。该 SDK 通过拦截对车队引擎的调用，然后将 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）：
- 当车辆驶过上车点时，车辆跟踪不会将车辆贴靠到路线上。
- 借助车辆跟踪功能，您可以显示车辆远离道路；例如，在未在地图上显示的停车场内。
当驾驶员的目的地与车队引擎中的目的地不匹配时，车辆图标不再强制显示过时路线。
系统现在会舍弃过时行程回复。

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