SDK مصرف کننده برای یادداشت های انتشار iOS

این بخش حاوی یادداشت‌های انتشار برای Consumer SDK برای iOS است.

نسخه 3.3.0 (مارس، 2024)

تغییر کرد

• از سازگاری Driver و Consumer SDK پشتیبانی می کند تا بتوان آنها را در یک برنامه ساخت.
• از Swift Package Manager برای Driver و Consumer SDK پشتیبانی می کند.

نسخه 3.2.0 (دسامبر، 2023)

تغییر کرد

• رفع اشکال و به روز رسانی اسناد.

منسوخ

• [GMTCMapView initWithCoder] در GMTCMapView منسوخ شده است.

نسخه 3.1.1 (اکتبر، 2023)

تغییر کرد

• رفع اشکال عدم فراخوانی متدهای GMSMapViewDelegate .

نسخه 3.1.0 (سپتامبر، 2023)

تغییر کرد

• CocoaPod for Consumer SDK اکنون یک چارچوب xc. است که از ساخت‌های دستگاه و شبیه‌ساز برای توسعه‌دهندگان در مک‌های مبتنی بر Intel و Apple Silicon پشتیبانی می‌کند.

نسخه 3.0.1 (اوت، 2023)

تغییر کرد

• رفع خطای نمادهای تعریف نشده

نسخه 3.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 ادامه خواهند داد. اگر وابستگی های شما شماره نسخه را مشخص نکند، IDE شما جدیدترین نسخه SDK را بارگیری می کند و ساخت های جدید برنامه شما از iOS 13 پشتیبانی نمی کنند. نسخه Consumer SDK برای iOS در وابستگی های ساخت برنامه شما به منظور کنترل زمانی که حداقل سیستم عامل پشتیبانی شده را برای نسخه های جدید برنامه خود افزایش می دهید.

اعلامیه

پشتیبانی فریز برای iOS 14 - 15 مه 2023

با توجه به خط مشی پشتیبانی نسخه سیستم عامل موبایل ، ما پشتیبانی از iOS 14 را در نسخه اصلی بعدی Consumer SDK برای iOS متوقف می کنیم.

نسخه‌های Consumer SDK برای iOS منتشر شده در سه ماهه دوم سال 2024 حداقل از iOS 15 پشتیبانی می‌کنند. نسخه‌های SDK قبلی به پشتیبانی از iOS 14 ادامه خواهند داد.

اگر وابستگی‌های شما شماره نسخه را مشخص نکند، IDE شما جدیدترین نسخه SDK را بارگیری می‌کند و ساخت‌های جدید برنامه شما از iOS 14 پشتیبانی نمی‌کنند.

نسخه ای از Consumer SDK برای iOS را در وابستگی های ساخت برنامه خود مشخص کنید تا کنترل کنید چه زمانی حداقل سیستم عامل پشتیبانی شده را برای نسخه های جدید برنامه خود افزایش می دهید.

نسخه 2.2.0 (فوریه، 2023)

تغییر کرد

• URL را برای شرایط و ضوابط موجود در فایل های سرصفحه به پیوند صحیح به روز می کند و سایر مشکلات جزئی را با علائم نگارشی برطرف می کند.
• رفع اشکالات مختلف املایی، نقطه گذاری، و دیگر اشتباهات جزئی در مستندات رفع شد.

نسخه 2.1.0 (12 سپتامبر 2022)

تغییر کرد

• رفع اشکال و به روز رسانی اسناد.

نسخه 2.0.0 (18 ژوئیه 2022)

تغییر کرد

• سرویس نقطه پایانی را حذف کرد که شامل موارد زیر است:

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

• پشتیبانی از iOS 12 اکنون متوقف شده است. حداقل نسخه iOS اکنون 13.0 است.

منسوخ

• اولیه سازهای منسوخ شده در کلاس عمومی GMTCMapView.

اعلامیه

در به‌روزرسانی‌های نسخه اصلی 2023 برای Consumer iOS SDK، پشتیبانی (منسوخ) را برای iOS 13 متوقف می‌کنیم. حداقل نسخه iOS پشتیبانی شده iOS 14 خواهد بود که از ژوئن 2023 شروع می شود. مشتریان باید قبل از به روز رسانی، پرچم پشتیبانی حداقل نسخه را در کد خود تغییر دهند.

نسخه 1.0.6 (24 مارس 2022)

رفع اشکال داخلی

نسخه 1.0 (7 دسامبر 2021)

حداقل نسخه iOS پشتیبانی شده برای این نسخه 12.0 است.

API تغییر می کند

احراز هویت تغییر می کند

• SDK برای پیاده‌سازی رابط AuthTokenFactory برای هر gRPC getToken() فراخوانی می‌کند. 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 متوقف می‌کنیم.

SDK مصرف‌کننده برای iOS نسخه 2.0 یا بالاتر فقط از دستگاه‌هایی پشتیبانی می‌کند که دارای حداقل iOS 13 هستند. نسخه‌های SDK قبلی همچنان از iOS 12 پشتیبانی می‌کنند.

اگر وابستگی‌های شما در CocoaPods یا Carthage شماره نسخه را مشخص نکند، Xcode جدیدترین نسخه را بارگیری می‌کند و بیلدهای جدید برنامه شما از iOS 12 پشتیبانی نمی‌کنند.

حتماً نسخه‌ای را در وابستگی‌های ساخت برنامه خود مشخص کنید تا کنترل کنید چه زمانی حداقل سیستم عامل پشتیبانی شده را برای نسخه‌های جدید برنامه خود افزایش می‌دهید. نمونه هایی از تعیین نسخه در Maps SDK برای اسناد iOS را ببینید. راهنمای بهترین شیوه های نگهداری برنامه را ببینید.

نسخه 0.11.0 (30 سپتامبر 2021)

تغییرات

• اضافه شدن تشخیص خرابی در طول اولیه سازی SDK. همچنین گزینه ای برای انصراف با استفاده از setAbnormalTerminationReportingEnabled: API در GMTCServices وجود دارد.

API تغییر می کند

پیشوند نام برای همه کلاس ها به روز شد:

• GRC -> GMTC ، به عنوان مثال GRCMapView -> GMTCMapView .
• GRS -> GMTS ، به عنوان مثال GRSTrip -> GMTSTrip .

GMTSAuthorization API به روز شد

• هنگامی که fetchAuthTokenForServiceType:authorizationContext:completion: فراخوانی می شود، kGMTSAuthorizationContextKeyTaskID کلید جدید برای تعیین شناسه کار در authorizationContext اضافه شد.

• فهرست GMTSServiceType به روز شد:

  ارزش قدیمی	ارزش جدید
  GMTSServiceTypeUnknown	GMTSServiceTypeUnspecified
  GMTSServiceTypeTripService
  GMTSServiceTypeVehicleService	GMTSServiceTypeVehicle
  GMTSServiceTypeTerminalPointService
  	GMTSServiceTypeTask

نسخه 0.10.0 (3 مه 2021)

تغییرات

پشتیبانی از iOS 10.x منسوخ شده است. حداقل نسخه iOS پشتیبانی شده اکنون 11.0 است.

API تغییر می کند

• GRCMutableMarkerStyleOptions را برای راحت‌تر کردن سفارشی‌سازی نشانگر اشتراک‌گذاری سفر معرفی کرد.

• tripModel:didUpdateRemainingRoute: و tripModel:didUpdateRemainingRouteDistance: در پروتکل GRCTripModelSubscriber ، برای تماس‌های به‌روزرسانی سفر زمانی که مسیر باقی‌مانده یا مسافت به‌روزرسانی شده است، معرفی شد.

نسخه 0.9.0 (25 ژانویه 2021)

بهبودها

• این نسخه Traffic Aware Polylines را برای اشتراک گذاری سفر معرفی می کند.

API تغییر می کند

• GRCMutablePolylineStyleOptions برای سفارشی‌سازی چند خطی معرفی کرد که می‌توان از آن برای فعال کردن رندر چند خطی ترافیک برای اشتراک‌گذاری سفر استفاده کرد.
• پاسخ تماس به‌روزرسانی داده ترافیک در GRCTripModelSubscriber اضافه شد:
  • tripModel:didUpdateActiveRouteTraffic:
• GRSTrafficData معرفی کرد.
• ویژگی جدید به GRSTripWaypoint برای دسترسی به داده های ترافیک اضافه شده است:
  • trafficData
• روش جدیدی در GRSTrip برای دسترسی به داده های ترافیک اضافه شده است:
  • activeRouteTraffic
  • remainingRouteTraffic

نسخه 0.6.7 (23 مارس 2020)

بهبودها

• وقتی وضعیت سفر ARRIVED_AT_PICKUP باشد، چند خط مسیر نمایش داده نمی‌شود.
• ردیابی خودروی خارج از مسیر بهبود یافته است (نیاز به DriverSDK 1.15 دارد):
  • ردیابی وسیله نقلیه وقتی وسیله نقلیه از نقطه وانت عبور می کند، وسیله نقلیه را به مسیر نمی برد.
  • ردیابی خودرو امکان نمایش خودرو در خارج از جاده را فراهم می کند. به عنوان مثال، در پارکینگ های بدون نقشه.
• وقتی مقصد راننده با مقصد در Fleet Engine مطابقت نداشته باشد، نمادهای خودرو دیگر مجبور به رفتن به یک مسیر قدیمی نمی شوند.
• پاسخ‌های منسوخ سفر اکنون حذف شده‌اند.

نسخه 0.6.3 (16 دسامبر 2019)

تغییرات

• سیاهههای مربوط به تاخیر درخواست سفر اضافه شده است.

• سیاهههای مربوط به خطاهای پاسخ سفر اضافه شده است.

نسخه 0.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 از GRCMapViewCustomerState حذف شدند.

  • GRCMapViewCustomerStateWaitingForPickup
  • GRCMapViewCustomerStateArrivedAtPickup
  • GRCMapViewCustomerStateEnRoute
  • GRCMapViewCustomerStateEndOfTrip

• چهار API تماس با MapView از GRCMapView حذف شدند.

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

• یک API پاسخ به تماس جدید به GRCMapView اضافه شد.

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

بهبودها

• زمانی که ETA به اولین نقطه بین لیست تغییر می کند، تمام ETA های باقیمانده بین راه را به روز کنید.

• هنگامی که راننده به نقطه وانت می‌رسد، دوربین را اجباری به مرکزیت مجدد خودکار کنید.

• محدوده‌های دوربین شامل مکان‌های تحویل و تحویل پس از رزرو سفر و قبل از در دسترس قرار گرفتن هر مکان خودروی مشابهی است.

نسخه 0.4.5 (28.0) (26 ژوئن 2019)

ویژگی های جدید

• پشتیبانی Carpool برای اشتراک گذاری سفر.

API تغییر می کند

• فیلد type از GRSTerminalLocation حذف شد.

رفع اشکال

• پویانمایی مسیر اکنون تنها زمانی اتفاق می‌افتد که بخش مسیر همگام باشد و در نتیجه تجربه کاربر بهبود یافته است.

• رفع مشکلی که در آن تماس با API isMarkerStyleOptionsCustomizedForType: برای GRCCustomizableMarkerTypeSelectedDropoffPoint همیشه NO برمی‌گرداند.

نسخه 0.4.3 (17 مه 2019)

ویژگی های جدید

• پشتیبانی پشتیبان برای Journey Sharing.
• اشتراک گذاری سفر اکنون از نرخ گزارش موقعیت مکانی پویا خودرو پشتیبانی می کند.

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

نوع GRCPolyline

ارزش قدیمی	ارزش جدید
GRCPolylineTypeTripRoute	GRCPolylineTypeActiveRoute
GRCPolylineTypeTripPreviewAutoRoute	GRCPolylineTypePreviewAutoRoute
GRCPolylineTypeTripPreviewTaxiRoute	GRCPolylineTypePreviewTaxiRoute
GRCPolylineTypeTripPreviewTruckRoute	GRCPolylineTypePreviewTruckRoute
GRCPolylineTypeTripPreviewTwoWheelerRoute	GRCPolylineTypePreviewTwoWheelerRoute
	GRCPolylineTypeRemainingRoute

GRCPolylineStyleOptions

ارزش قدیمی	ارزش جدید
	zIndex

GRSTrip

ارزش قدیمی	ارزش جدید
	ویژگی remainingWaypoints
دارایی route
ویژگی remainingDistanceInMeters
	GRSTripWaypoint

بهبودها

• کاهش مصرف شبکه برای اشتراک گذاری سفر.
• نامزد انتخابی پیکاپ اکنون برجسته شده است.
• سازگار با Maps SDK v3.1.0

رفع اشکال

• مشکلی که نشانگرها به ضربه زدن برای بار دوم پاسخ نمی‌دهند، برطرف شد.
• مشکلی را برطرف کرد که در آن محدوده‌های دوربین mapView گاهی اوقات یک نمای غیرمنتظره را در ابتدا، پس از رزرو سفر نشان می‌دادند.
• مشکل API نسخه SDK حل شد.