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

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

v9.0 (กรกฎาคม 2024)

เปลี่ยนแปลง

• รองรับ Geo iOS SDK เวอร์ชัน 9.0
• การรองรับ iOS 14 หยุดลงแล้ว เวอร์ชัน iOS ขั้นต่ำที่ใช้ได้คือ 15.0
• รุ่นนี้รวมไฟล์ .xcprivacy เพื่อรองรับไฟล์ Manifest ความเป็นส่วนตัวของ Apple
• รวมถึงการแก้ไขที่อาจเกิดขึ้นสำหรับการขัดข้องที่เกี่ยวข้องกับบันทึกซึ่งเกิดขึ้นได้น้อย

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 สำหรับ 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 เวอร์ชัน 3.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

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)

เปลี่ยนแปลง

• นำบริการจุดปลายทางออก ซึ่งรวมถึง

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

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

เลิกใช้

• ตัวเริ่มต้นที่เลิกใช้งานแล้วในคลาสสาธารณะ GMTCMapView

ประกาศ

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

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 เวอร์ชันหลักที่กำลังจะเปิดตัว เพื่อตอบสนองต่อการเปลี่ยนแปลงในข้อกำหนดเบื้องต้นภายใน

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

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

อย่าลืมระบุเวอร์ชันในข้อกำหนดของบิลด์แอปพลิเคชันเพื่อควบคุมเวลาที่คุณเพิ่มระบบปฏิบัติการขั้นต่ำที่รองรับสำหรับแอปเวอร์ชันใหม่ ดูตัวอย่างการระบุเวอร์ชันในเอกสารประกอบของ 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:

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

  ค่าเดิม	ค่าใหม่
  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)

การปรับปรุง

• เวอร์ชันนี้เปิดตัวเส้นประกอบที่คำนึงถึงสภาพการจราจรสำหรับการแชร์เส้นทาง

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

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

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 แสดงผลเป็น "ไม่" เสมอ

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

ฟีเจอร์ใหม่

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

การเปลี่ยนแปลง 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

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

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