บันทึกประจำรุ่น SDK สำหรับผู้บริโภคของ iOS

ส่วนนี้ประกอบด้วยบันทึกประจำรุ่นสำหรับ Consumer SDK สำหรับ iOS

v3.3.0 (มีนาคม 2024)

เปลี่ยนแปลง

  • รองรับความเข้ากันได้ของไดรเวอร์และ SDK ของผู้บริโภคเพื่อให้สร้างได้ในแอปเดียวกัน
  • รองรับ Swift Package Manager สำหรับ Driver และ Consumer SDK

v3.2.0 (ธันวาคม 2023)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องและการอัปเดตเอกสารประกอบ

เลิกใช้

  • เลิกใช้งาน [GMTCMapView initWithCoder] ใน GMTCMapView แล้ว

v3.1.1 (ตุลาคม 2023)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องที่มีการเรียกเมธอด GMSMapViewDelegate รายการไม่ได้

v3.1.0 (ก.ย. 2023)

เปลี่ยนแปลง

  • CocoaPod for Consumer SDK เปลี่ยนเป็น .xcframework แล้วในตอนนี้ ซึ่งรองรับทั้งบิลด์ของอุปกรณ์และเครื่องจำลองสำหรับนักพัฒนาซอฟต์แวร์ทั้งใน Mac ที่ใช้ Intel และ Apple Silicon

v3.0.1 (ส.ค. 2023)

เปลี่ยนแปลง

  • แก้ไขข้อผิดพลาดเกี่ยวกับสัญลักษณ์ที่ระบุไม่ได้

v3.0.0 (พฤษภาคม 2023)

เปลี่ยนแปลง

  • นำการเริ่มต้นที่เลิกใช้งานแล้วใน GMTCMapView ออก
  • แก้ไขการดึงข้อมูลโทเค็นการตรวจสอบสิทธิ์อย่างต่อเนื่องหลังจากที่นำสมาชิกทั้งหมดออกจาก GMTCTripModel แล้ว
  • การรองรับ iOS 13 หยุดลงแล้ว ขณะนี้เวอร์ชัน iOS ขั้นต่ำคือ 14.0
  • Xcode เวอร์ชันใหม่ที่รองรับขั้นต่ำคือ 14.0 ดูการเลิกใช้งานในบันทึกประจำรุ่นของ Xcode 14 เกี่ยวกับการสิ้นสุดการรองรับการสร้างด้วย บิตโค้ด
  • ตามนโยบายการสนับสนุนเวอร์ชันระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เราจะหยุดรองรับ iOS 13 สำหรับ Consumer SDK สำหรับ iOS v3.0.0 ระบบปฏิบัติการขั้นต่ำใหม่ที่รองรับคือ iOS 14 SDK เวอร์ชันก่อนหน้าจะยังรองรับ iOS 13 ต่อไป หากทรัพยากร Dependency ไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันล่าสุดและบิลด์ใหม่ของแอปจะไม่รองรับ iOS 13 ระบุเวอร์ชันของ Consumer SDK สำหรับ iOS ในทรัพยากร Dependency ของแอป เพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่

ประกาศ

การรองรับชั่วคราวสำหรับ iOS 14 - 15 พฤษภาคม 2023

ตามนโยบายการรองรับเวอร์ชันระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่ เราจะหยุดรองรับ iOS 14 ใน Consumer SDK เวอร์ชันหลักที่กำลังจะเปิดตัวสำหรับ iOS

เวอร์ชัน Consumer SDK สำหรับ iOS ที่เปิดตัวไปตั้งแต่ไตรมาสที่ 2 ของปี 2024 จะรองรับ iOS 15 เป็นอย่างต่ำ SDK เวอร์ชันก่อนหน้าจะยังรองรับ iOS 14 ต่อไป

หากทรัพยากร Dependency ไม่ได้ระบุหมายเลขเวอร์ชัน IDE จะโหลด SDK เวอร์ชันใหม่ล่าสุด และบิลด์ใหม่ของแอปจะไม่รองรับ iOS 14

ระบุเวอร์ชันของ Consumer SDK สำหรับ iOS ในทรัพยากร Dependency ของบิลด์ของแอปพลิเคชันเพื่อควบคุมเวลาที่คุณจะเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่

v2.2.0 (กุมภาพันธ์ 2023)

เปลี่ยนแปลง

  • อัปเดต URL สำหรับข้อกำหนดและเงื่อนไขในไฟล์ส่วนหัวเป็นลิงก์ที่ถูกต้อง และแก้ไขปัญหาเล็กๆ น้อยๆ เกี่ยวกับเครื่องหมายวรรคตอน
  • แก้ไขข้อผิดพลาดด้านการสะกด เครื่องหมายวรรคตอน และข้อผิดพลาดเล็กน้อยอื่นๆ ในเอกสาร

v2.1.0 (12 กันยายน 2022)

เปลี่ยนแปลง

  • แก้ไขข้อบกพร่องและการอัปเดตเอกสารประกอบ

v2.0.0 (18 กรกฎาคม 2022)

เปลี่ยนแปลง

  • นำบริการ Terminal Point ออกแล้ว ซึ่งรวมถึง:

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • การรองรับ iOS 12 หยุดลงแล้ว ขณะนี้เวอร์ชัน iOS ขั้นต่ำคือ 13.0

เลิกใช้

  • เครื่องมือเริ่มต้นการเลิกใช้งานในคลาส GMTCMapView สาธารณะ

ประกาศ

เราจะหยุดรองรับ (จะเลิกใช้งาน) สำหรับ iOS 13 ในการอัปเดตเวอร์ชันหลักปี 2023 สำหรับ Consumer iOS SDK เวอร์ชัน iOS ขั้นต่ำที่รองรับคือ iOS 14 ตั้งแต่เดือนมิถุนายน 2023 เป็นต้นไป ลูกค้าควรเตรียมความพร้อมโดยเปลี่ยนการแจ้งการสนับสนุนเวอร์ชันขั้นต่ำในโค้ดของตนก่อนที่จะอัปเดต

v1.0.6 (24 มีนาคม 2022)

แก้ไขข้อบกพร่องภายใน

v1.0 (7 ธันวาคม 2021)

iOS เวอร์ชันต่ำสุดที่รองรับสำหรับรุ่นนี้คือ 12.0

การเปลี่ยนแปลง API

การเปลี่ยนแปลงการตรวจสอบสิทธิ์

  • SDK เรียกใช้ getToken() สำหรับการใช้งานอินเทอร์เฟซ AuthTokenFactory สำหรับ gRPC แต่ละรายการ SDK ดำเนินการดังกล่าวโดยสกัดกั้นการเรียกใช้ Fleet Engine จากนั้นแนบ JWT ที่แสดงผลจาก getToken() ไปยังส่วนหัวการให้สิทธิ์ HTTP โปรดทราบว่าคุณเป็นผู้สร้างโทเค็นที่ถูกต้อง นั่นคือโทเค็นที่ยังไม่หมดอายุและที่มีการอ้างสิทธิ์ที่เหมาะสม

  • เปลี่ยน GMTSAuthorization เป็น GMTCAuthorization แล้ว

  • นำ GMTSServiceType ออกแล้ว

การเปลี่ยนแปลงข้อมูลการเดินทางและการติดต่อกลับ

  • อัปเดตชื่อที่พัก remainingDistanceOfActiveRouteInMeters แล้ว

  • เพิ่มข้อมูลการจราจรที่อัปเดตเป็น GMTCTripModelSubscriber แล้ว

  • เพิ่มพร็อพเพอร์ตี้ remainingDistanceOfCurrentRouteInMeters แล้ว

  • เพิ่มพร็อพเพอร์ตี้ใหม่ใน GMTSTripPropertyFields:

    • GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters.
    • GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute.
    • GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute.
    • GMTSTripPropertyFieldRemainingRouteTraffic.

  • เพิ่มพร็อพเพอร์ตี้ใหม่ remainingDistanceOfActiveRouteInMeters และ distanceOfRemainingRouteInMeters ใน GMTSTrip แล้ว

  • ตอนนี้ RegisterSubscriber จะเริ่มตรวจสอบการเดินทางโดยอัตโนมัติสำหรับ tripModel UnregisterSubscriber จะหยุดการตรวจสอบเมื่อไม่มีสมาชิกเพิ่มเติม ModelState และ ModelOptions เปลี่ยนชื่อเป็น state และ options ตามลำดับ นำ stop และ start ออกจากส่วนหัวสาธารณะแล้ว

    • เปลี่ยนชื่อ modelState เป็น state แล้ว
    • เปลี่ยนชื่อ modelOptions เป็น options แล้ว
    • นำ start() และ stop() ใน TripModel ออกแล้ว

การเปลี่ยนแปลงอื่นๆ ของ API

  • นำ GMTSTripPreview และ GMTSTripPreviewVehicleOptions ออกแล้ว

  • นำบริการเลือกจุดรับสินค้าออก ซึ่งรวมถึง

    • GMTSPickupPointArea.
    • GMTSPickupPointGroup.
    • GMTSPickupPointMatch.

การรองรับชั่วคราวสำหรับ iOS 12 - 18 ตุลาคม 2021

เราจะหยุดรองรับ iOS 12 ในเวอร์ชันหลักสำหรับ Consumer SDK สำหรับ iOS เพื่อตอบสนองต่อการเปลี่ยนแปลงในทรัพยากร Dependency ภายในของเรา

SDK สำหรับผู้บริโภคสำหรับ iOS เวอร์ชัน 2.0 ขึ้นไปจะรองรับเฉพาะอุปกรณ์ที่ใช้ iOS 13 ขึ้นไปเท่านั้น SDK เวอร์ชันก่อนหน้าจะยังรองรับ iOS 12 ต่อไป

หากทรัพยากร Dependency ใน CocoaPods หรือ Carthage ไม่ได้ระบุหมายเลขเวอร์ชัน Xcode จะโหลดเวอร์ชันล่าสุดและบิลด์ใหม่ของแอปจะไม่รองรับ iOS 12

อย่าลืมระบุเวอร์ชันในทรัพยากร Dependency ของบิลด์ของแอปพลิเคชันเพื่อควบคุมการเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่ ดูตัวอย่างการระบุเวอร์ชันในเอกสาร Maps SDK สำหรับ iOS ดูคำแนะนำเกี่ยวกับแนวทางปฏิบัติแนะนำในการบำรุงรักษาแอป

v0.11.0 (30 ก.ย. 2021)

การเปลี่ยนแปลง

  • เพิ่มการตรวจจับข้อขัดข้องระหว่างการเริ่มต้น SDK นอกจากนี้ คุณยังเลือกไม่ใช้ได้โดยใช้ setAbnormalTerminationReportingEnabled: API ใน GMTCServices

การเปลี่ยนแปลง API

อัปเดตคำนำหน้าชื่อสำหรับทุกชั้นเรียนแล้ว

  • GRC -> GMTC เช่น GRCMapView -> GMTCMapView
  • GRS -> GMTS เช่น GRSTrip -> GMTSTrip

อัปเดต GMTSAuthorization API แล้ว

  • เพิ่มคีย์ใหม่ kGMTSAuthorizationContextKeyTaskID สำหรับการระบุรหัสงานใน authorizationContext เมื่อมีการเรียกใช้ fetchAuthTokenForServiceType:authorizationContext:completion:

  • อัปเดต enum ของ GMTSServiceType แล้ว

    ค่าเดิม ค่าใหม่
    GMTSServiceTypeUnknown GMTSServiceTypeUnspecified
    GMTSServiceTypeTripService
    GMTSServiceTypeVehicleService GMTSServiceTypeVehicle
    GMTSServiceTypeTerminalPointService
    GMTSServiceTypeTask

v0.10.0 (3 พฤษภาคม 2021)

การเปลี่ยนแปลง

เลิกใช้งานการรองรับ iOS 10.x ขณะนี้เวอร์ชัน iOS ขั้นต่ำที่รองรับคือ 11.0

การเปลี่ยนแปลง API

  • เปิดตัว GRCMutableMarkerStyleOptions เพื่อให้การปรับแต่งเครื่องหมายการแชร์เส้นทางสะดวกยิ่งขึ้น

  • เริ่มใช้ tripModel:didUpdateRemainingRoute: และ tripModel:didUpdateRemainingRouteDistance: ในโปรโตคอล GRCTripModelSubscriber สำหรับการเรียกกลับเพื่ออัปเดตการเดินทางเมื่ออัปเดตเส้นทางที่เหลือหรือระยะทางแล้ว

v0.9.0 (25 มกราคม 2021)

การปรับปรุง

  • รุ่นนี้ขอแนะนำ Traffic Aware Polylines สำหรับการแชร์เส้นทาง

การเปลี่ยนแปลง API

  • เปิดตัว GRCMutablePolylineStyleOptions สำหรับการปรับแต่งเส้นประกอบ ซึ่งสามารถใช้เพื่อเปิดใช้การแสดงผลโพลีไลน์การเข้าชมสำหรับการแชร์เส้นทางได้
  • เพิ่มการติดต่อกลับอัปเดตข้อมูลการเข้าชมใน GRCTripModelSubscriber:
  • เปิดตัว GRSTrafficData
  • เพิ่มพร็อพเพอร์ตี้ใหม่ใน GRSTripWaypoint สำหรับการเข้าถึงข้อมูลการเข้าชม:
  • เพิ่มเมธอดใหม่ใน GRSTrip สำหรับการเข้าถึงข้อมูลการเข้าชม

v0.6.7 (23 มีนาคม 2020)

การปรับปรุง

  • เส้นประกอบเส้นทางจะไม่แสดงเมื่อสถานะการเดินทางคือ ARRIVED_AT_PICKUP
  • การติดตามยานพาหนะนอกเส้นทางได้รับการปรับปรุงให้ดีขึ้น (ต้องใช้ DriverSDK 1.15)
    • การติดตามยานพาหนะจะไม่สแนปรถไปยังเส้นทางเมื่อรถขับผ่านจุดรับ
    • การติดตามยานพาหนะทำให้สามารถแสดงยานพาหนะจากท้องถนนได้ เช่น ในลานจอดรถที่ไม่ได้ทำแผนที่
  • ระบบจะไม่บังคับให้ไอคอนยานพาหนะไปยังเส้นทางที่ไม่มีการอัปเดตอีกต่อไปเมื่อจุดหมายของคนขับไม่ตรงกับจุดหมายใน Fleet Engine
  • คำตอบเกี่ยวกับการเดินทางที่ไม่เป็นปัจจุบันจะหายไป

v0.6.3 (16 ธันวาคม 2019)

การเปลี่ยนแปลง

  • เพิ่มบันทึกสำหรับเวลาในการตอบสนองของคำขอการเดินทาง

  • เพิ่มบันทึกสำหรับข้อผิดพลาดในการตอบกลับการเดินทาง

v0.5.4(86.0) (7 สิงหาคม 2019)

ฟีเจอร์ใหม่

  • การรองรับหลายปลายทางสำหรับการแชร์เส้นทางการท่องเว็บ

การเปลี่ยนแปลง API

  • เพิ่มสถานะการเดินทางใหม่ใน GRSTripStatus แล้ว

    • GRSTripStatusEnrouteToIntermediateDestination.
    • GRSTripStatusArrivedAtIntermediateDestination.

  • เพิ่มที่พักใหม่ใน GRSTrip แล้ว

    • intermediateDestinations.
    • intermediateDestinationIndex.

  • เพิ่ม API เรียกกลับใหม่ไปยัง GRCTripServiceSubscriber แล้ว

    • - (void)tripService:(GRCTripService *)service didUpdateETAToNextWaypoint:(NSTimeInterval)nextWaypointETA;

    • - (void)tripService:(GRCTripService *)service didUpdateIntermediateDestinations: (nullable NSArray<GRSTerminalLocation *> *)intermediateDestinations;

  • เพิ่ม enum ของประเภทเครื่องหมายใหม่ไปยัง GRCMapViewMarkerType แล้ว

    • GRCMapViewMarkerTypeIntermediateDestination.

  • เพิ่ม enum ของประเภทเครื่องหมายที่ปรับแต่งได้ใหม่ไปยัง GRCCustomizableMarkerType แล้ว

    • GRCCustomizableMarkerTypeIntermediateDestination

  • เพิ่ม MapViewCustomerState ใหม่ไปยัง GRCMapViewCustomerState แล้ว

    • GRCMapViewCustomerStateJourneySharing

  • ลบสมาชิก mapViewCustomerState 4 รายการออกจาก GRCMapViewCustomerState แล้ว

    • GRCMapViewCustomerStateWaitingForPickup
    • GRCMapViewCustomerStateArrivedAtPickup
    • GRCMapViewCustomerStateEnRoute
    • GRCMapViewCustomerStateEndOfTrip

  • ลบ API เรียกกลับ MapView 4 รายการออกจาก GRCMapView แล้ว

    • -(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;
    • -(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;
    • -(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;
    • -(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;

  • เพิ่ม API เรียกกลับใหม่ลงใน GRCMapView แล้ว

    • - (void)mapViewDidStartJourneySharing:(GRCMapView *)mapView;

การปรับปรุง

  • อัปเดตเวลาถึงโดยประมาณที่เหลืออยู่ทั้งหมดเมื่อเวลาถึงโดยประมาณไปยังจุดอ้างอิงแรกในรายการมีการเปลี่ยนแปลง

  • บังคับให้ปรับกึ่งกลางกล้องใหม่โดยอัตโนมัติเมื่อคนขับมาถึงจุดรับ

  • ขอบเขตของกล้องจะมีทั้งตำแหน่งรับและส่งคืนหลังจากจองการเดินทาง และก่อนที่สถานที่ที่ตรงกันจะแสดงยานพาหนะที่ตรงกัน

v0.4.5(28.0) (26 มิถุนายน 2019)

ฟีเจอร์ใหม่

  • การสนับสนุนการโดยสารรถร่วมกันสำหรับการแชร์เส้นทาง

การเปลี่ยนแปลง API

  • นําช่อง type ออกจาก GRSTerminalLocation แล้ว

แก้ไขข้อบกพร่อง

  • ตอนนี้ภาพเคลื่อนไหวของเส้นทางจะเกิดขึ้นเฉพาะเมื่อส่วนของเส้นทางมีการซิงค์เท่านั้น ซึ่งส่งผลให้ประสบการณ์ของผู้ใช้ดีขึ้น

  • แก้ไขปัญหาที่การเรียก API isMarkerStyleOptionsCustomizedForType: สำหรับ GRCCustomizableMarkerTypeSelectedDropoffPoint แสดงผลเป็น NO เสมอ

v0.4.3 (17 พฤษภาคม 2019)

ฟีเจอร์ใหม่

  • กลับไปที่การสนับสนุนด้านหลังสำหรับการแชร์เส้นทางการท่องเว็บ
  • ตอนนี้การแชร์เส้นทางการท่องเว็บรองรับอัตราการรายงานตำแหน่งแบบไดนามิกของยานพาหนะแล้ว

การเปลี่ยนแปลง 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 v3.1.0 ได้

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเครื่องหมายไม่ตอบสนองต่อการแตะเป็นครั้งที่ 2
  • แก้ไขปัญหาที่บางครั้งขอบเขตกล้องของ MapView แสดงวิวพอร์ตที่ไม่คาดคิดเมื่อเริ่มต้นหลังจากจองการเดินทาง
  • แก้ปัญหาเกี่ยวกับ SDK Version API