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

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

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

เปลี่ยนแปลง

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

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

เปลี่ยนแปลง

• รองรับความเข้ากันได้ของ Driver และ Consumer SDK เพื่อให้สร้างในแอปเดียวกันได้
• รองรับ Swift Package Manager สำหรับ 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 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

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

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

เปลี่ยนแปลง

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

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

เปลี่ยนแปลง

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

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

เปลี่ยนแปลง

• นำ Terminal Point Service ออกแล้ว ซึ่งรวมถึง

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

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

เลิกใช้

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

ประกาศ

เรากำลังยกเลิกการรองรับ (เลิกใช้งาน) สำหรับ iOS 13 ในการอัปเดตเวอร์ชันหลักปี 2023 สำหรับ 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 ออกแล้ว

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

• อัปเดตชื่อพร็อพเพอร์ตี้ของการเดินทาง: 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

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

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 สำหรับ Callback อัปเดตการเดินทางเมื่ออัปเดตเส้นทางที่เหลือหรือระยะทางแล้ว

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

การปรับปรุง

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

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

• เปิดตัว GRCMutablePolylineStyleOptions สำหรับการปรับแต่งโพลีไลน์ ซึ่งสามารถใช้เพื่อเปิดใช้การแสดงผลเส้นประกอบการเข้าชมสำหรับการแชร์เส้นทาง
• เพิ่ม Callback เพื่ออัปเดตข้อมูลการจราจรใน 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

• เพิ่ม Callback 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 ของ Callback ของ MapView 4 รายการจาก GRCMapView แล้ว

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

• เพิ่ม Callback 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

โปรโตคอล 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
• แก้ไขปัญหาที่บางครั้งขอบเขตกล้องของ MapsView แสดงวิวพอร์ตที่ไม่คาดคิดตั้งแต่เริ่มต้น หลังจากมีการจองการเดินทาง
• แก้ไขปัญหาเกี่ยวกับ SDK Version API