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 的 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。 在应用的 build 依赖项中指定适用于 iOS 的 Consumer SDK 版本，以便控制何时提高应用新版本支持的最低操作系统版本。

通知

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

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

自 2024 年第 2 季度起发布的 iOS 版消费者 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 变更

身份验证方面的变更

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

变更

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 变更

v0.9.0（2021 年 1 月 25 日）

改进

API 变更

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