Consumer SDK for iOS 版本資訊

本節包含 Consumer SDK for iOS 的版本資訊。

3.3.0 版 (2024 年 3 月)

已變更

  • 支援驅動程式和消費者 SDK 相容性，因此可在同一個應用程式中建構。
  • 支援驅動程式和消費者端 SDK 適用的 Swift Package Manager。

3.2.0 版 (2023 年 12 月)

已變更

  • 錯誤修正和說明文件更新。

已淘汰

  • 淘汰了 GMTCMapView 中的 [GMTCMapView initWithCoder]。

3.1.1 版 (2023 年 10 月)

已變更

  • 修正未呼叫 GMSMapViewDelegate 方法的錯誤。

3.1.0 版 (2023 年 9 月)

已變更

  • Consumer SDK 專用的 CocoaPod 現已改名為 .xcframework，以便開發人員在搭載 Intel 和 Apple Silicon 的 Mac 上進行裝置和模擬器建構。

3.0.1 版 (2023 年 8 月)

已變更

  • 修正未定義的符號錯誤。

3.0.0 版 (2023 年 5 月)

已變更

  • 移除 GMTCMapView 中已淘汰的 Initializer。
  • 修正從 GMTCTripModel 移除所有訂閱者後，繼續擷取驗證權杖的問題。
  • 系統現已凍結對 iOS 13 的支援。目前的最低 iOS 版本為 14.0 版。
  • 新的支援的最低 Xcode 版本為 14.0。記下 Xcode 14 版本資訊中的淘汰項目，開始支援以位元碼進行建構。
  • 根據行動作業系統版本支援政策，自 iOS 3.0.0 版消費者 SDK 已無法支援 iOS 13。新的支援 OS 最低需求為 iOS 14。舊版 SDK 會繼續支援 iOS 13。 如果依附元件未指定版本號碼，IDE 會載入最新版 SDK，但新的應用程式版本將不支援 iOS 13。請在應用程式的建構依附元件中指定 iOS 版 Consumer SDK 版本，以便控管何時提高新版應用程式支援的最低作業系統需求。

公告

系統凍結支援 iOS 14 - 2023 年 5 月 15 日

根據Mobile OS 版本支援政策，我們將於即將推出的 iOS 版 Consumer SDK 主要版本中限制 iOS 14 的支援。

自 2024 年第 2 季起，iOS 適用的 Consumer SDK 版本將支援至少 iOS 15 版本。舊版 SDK 會繼續支援 iOS 14。

如果依附元件未指定版本號碼，IDE 會載入最新的 SDK 版本，且應用程式的新版本將不支援 iOS 14。

請在應用程式的建構依附元件中指定 iOS 版 Consumer SDK 的版本，以便控管新版本應用程式支援的最低作業系統需求。

2.2.0 版 (2023 年 2 月)

已變更

  • 將標頭檔案中的條款及細則網址更新為正確的連結，並修正標點符號的其他小問題。
  • 該說明文件修正了各種拼字、標點符號和其他小錯誤。

2.1.0 版 (2022 年 9 月 12 日)

已變更

  • 錯誤修正和說明文件更新。

2.0.0 版 (2022 年 7 月 18 日)

已變更

  • 移除航站點服務，包括：

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • 系統現已凍結對 iOS 12 的支援。目前的最低 iOS 版本為 13.0 版。

已淘汰

  • 淘汰公用類別 GMTCMapView 中的 Initializer。

公告

在 2023 年 Consumer iOS SDK 的主要版本更新中，我們將停止為 iOS 13 提供支援 (已淘汰)。自 2023 年 6 月起，支援的最低 iOS 版本將會是 iOS 14 版本。客戶應在更新前變更程式碼中的最低版本支援旗標，藉此做好準備。

1.0.6 版 (2022 年 3 月 24 日)

修正內部錯誤。

1.0 版 (2021 年 12 月 7 日)

此版本支援的最低 iOS 版本為 12.0。

API 變更

驗證變更

  • SDK 會呼叫 getToken()，並針對每個 gRPC 實作 AuthTokenFactory 介面。為達成此目的，SDK 會攔截對 Fleet Engine 的呼叫，然後將傳回的 JWT 從 getToken() 附加至 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 2.0 以上版本的 Consumer SDK 僅支援搭載 iOS 13 以下版本的裝置。舊版 SDK 將繼續支援 iOS 12。

如果 CocoaPods 或 Carthage 中的依附元件未指定版本號碼，Xcode 會載入最新版本，而應用程式的新版本將不支援 iOS 12。

請務必在應用程式的建構依附元件中指定版本，以便控制何時提高新版應用程式支援的最低作業系統。如需指定版本的範例，請參閱 Maps SDK for iOS 說明文件。 請參閱應用程式維護最佳做法指南。

0.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

0.10.0 版 (2021 年 5 月 3 日)

異動

不再支援 iOS 10.x。目前支援的最低 iOS 版本為 11.0 版。

API 變更

0.9.0 版 (2021 年 1 月 25 日)

改善項目

API 變更

0.6.7 版 (2020 年 3 月 23 日)

改善項目

  • 行程狀態為 ARRIVED_AT_PICKUP 時，不會顯示路線折線。
  • 改善離境車輛追蹤 (必須使用 DriverSDK 1.15)：
    • 當車輛行駛在上車點上時，車輛追蹤不會將車輛貼進路線。
    • 車輛追蹤功能可展示車輛外部的車輛狀態，例如無對應的停車場。
  • 如果驅動程式的目的地與 Fleet Engine 中的目的地不符，車輛圖示將不再強制採用過時路徑。
  • 系統現在會捨棄過期的行程回應。

0.6.3 版 (2019 年 12 月 16 日)

異動

  • 新增行程要求延遲時間的記錄。

  • 新增行程回應錯誤的記錄。

0.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」刪除四位 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;

改善項目

  • 在清單的第一個路線控點變更時，更新所有剩餘路線控點的預計到達時間。

  • 強制駕駛抵達上車地點時，強制相機自動重新置中。

  • 攝影機邊界會同時包含預訂行程後及有人抵達任何相符的車輛地點前，會同時包含上車和下車地點。

0.4.5(28.0 版) (2019 年 6 月 26 日)

新功能

  • 透過共乘服務分享旅程。

API 變更

  • 「type」欄位已從 GRSTerminalLocation 中移除。

修正錯誤

  • 現在只有在路徑片段同步時，系統才會產生路徑動畫，藉此提升使用者體驗。

  • 已修正對 GRCCustomizableMarkerTypeSelectedDropoffPoint 呼叫 API isMarkerStyleOptionsCustomizedForType: 時一律傳回 NO 的問題。

0.4.3 版 (2019 年 5 月 17 日)

新功能

  • 返回歷程分享支援。
  • 行程分享功能現在支援動態車輛定位回報率。

API 變更

GRCMapViewMarkerType

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

GRCMapView

舊值 新值
redrawRidesharingOverlays

GRCTripService 訂閱者通訊協定

舊值 新值
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 3.1.0 版

修正錯誤

  • 修正標記在第二次未回應輕觸的問題。
  • 修正了 mapView 的攝影機邊界在預訂行程之後，有時可能會顯示非預期的可視區域。
  • 已修正 SDK 版本 API 的問題。