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

این بخش شامل نکات انتشار برای Consumer SDK برای iOS است.

نسخه ۱۰.۰.۰ (ژوئن ۲۰۲۵)

تغییر یافته

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

تغییرات API

  • کلاس GMTSVehicleLocationOptions را اضافه می‌کند، که در آن می‌توانید از ویژگی serverTime برای تعیین زمان دریافت آخرین به‌روزرسانی موقعیت مکانی توسط Fleet Engine استفاده کنید.
  • مقداردهنده اولیه initWithOptions<GMTSVehicleLocationOptions> را در GMTSVehicleLocation اضافه می‌کند.
  • مقداردهی اولیه initWithLatLng:GMTSLatLng در GMTSVehicleLocation منسوخ می‌کند. در عوض، از مقداردهی اولیه initWithOptions:<GMTSVehicleLocationOptions> استفاده کنید.

نسخه ۹.۲.۱ (آوریل ۲۰۲۵)

تغییر یافته

  • خطای نمادهای تعریف نشده را برطرف می‌کند.

نسخه ۹.۲ (ژانویه ۲۰۲۵)

تغییر یافته

  • نسخه از ۹.۰ به ۹.۲ ارتقا یافت.
  • از استایل‌دهی نقشه‌های مبتنی بر ابر پشتیبانی می‌کند.
  • از کاربران برای بازیابی وضعیت «موقعیت خودرو» در طول سفر پشتیبانی می‌کند.
  • یک مشکل نادر که باعث ناپدید شدن چندخطی می‌شد، برطرف شد.

نسخه ۹.۰ (ژوئیه ۲۰۲۴)

تغییر یافته

  • پشتیبانی از SDK های Geo iOS نسخه 9.0.
  • پشتیبانی از iOS 14 اکنون متوقف شده است. حداقل نسخه iOS اکنون 15.0 است.
  • این نسخه شامل فایل .xcprivacy برای پشتیبانی از Apple Privacy Manifests است.
  • شامل یک راه حل بالقوه برای یک خرابی نادر مربوط به گزارش‌ها است.

نسخه ۳.۳.۰ (مارس ۲۰۲۴)

تغییر یافته

  • از سازگاری SDK های درایور و مصرف کننده پشتیبانی می‌کند تا بتوان آنها را در یک برنامه ساخت.
  • از مدیر بسته Swift برای SDK های درایور و مصرف کننده پشتیبانی می کند.

نسخه ۳.۲.۰ (دسامبر ۲۰۲۳)

تغییر یافته

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

منسوخ شده

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

نسخه ۳.۱.۱ (اکتبر ۲۰۲۳)

تغییر یافته

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

نسخه ۳.۱.۰ (سپتامبر ۲۰۲۳)

تغییر یافته

  • کیت توسعه نرم‌افزار CocoaPod برای مصرف‌کنندگان اکنون یک چارچوب .xc است که از ساخت دستگاه و شبیه‌ساز برای توسعه‌دهندگان در هر دو مک مبتنی بر اینتل و اپل سیلیکون پشتیبانی می‌کند.

نسخه ۳.۰.۱ (آگوست ۲۰۲۳)

تغییر یافته

  • خطای نمادهای تعریف نشده را برطرف می‌کند.

نسخه ۳.۰.۰ (مه ۲۰۲۳)

تغییر یافته

  • مقداردهی اولیه منسوخ شده را در GMTCMapView حذف می‌کند.
  • رفع مشکل ادامه‌ی واکشی توکن‌های احراز هویت پس از حذف تمام مشترکین از GMTCTripModel .
  • پشتیبانی از iOS 13 اکنون متوقف شده است. حداقل نسخه iOS اکنون ۱۴.۰ است.
  • حداقل نسخه جدید پشتیبانی شده Xcode، نسخه ۱۴.۰ است. به توضیحات منسوخ شده در یادداشت‌های انتشار Xcode 14 در مورد پایان پشتیبانی از ساخت با استفاده از bitcode توجه کنید.
  • طبق سیاست پشتیبانی از نسخه سیستم‌عامل موبایل، ما پشتیبانی از iOS 13 را از Consumer SDK برای iOS نسخه ۳.۰.۰ متوقف می‌کنیم. حداقل سیستم‌عامل جدید پشتیبانی‌شده iOS 14 است. نسخه‌های قبلی SDK همچنان از iOS 13 پشتیبانی خواهند کرد. اگر وابستگی‌های شما شماره نسخه را مشخص نکنند، IDE شما جدیدترین نسخه SDK را بارگذاری می‌کند و نسخه‌های جدید برنامه شما از iOS 13 پشتیبانی نخواهند کرد. برای کنترل زمان افزایش حداقل سیستم‌عامل پشتیبانی‌شده برای نسخه‌های جدید برنامه، نسخه‌ای از Consumer SDK برای iOS را در وابستگی‌های ساخت برنامه خود مشخص کنید.

اطلاعیه

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

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

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

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

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

نسخه ۲.۲.۰ (فوریه ۲۰۲۳)

تغییر یافته

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

نسخه ۲.۱.۰ (۱۲ سپتامبر ۲۰۲۲)

تغییر یافته

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

نسخه ۲.۰.۰ (۱۸ ژوئیه ۲۰۲۲)

تغییر یافته

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

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

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

منسوخ شده

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

اطلاعیه

ما پشتیبانی از iOS 13 را در به‌روزرسانی‌های اصلی نسخه ۲۰۲۳ برای SDK iOS مخصوص کاربران، متوقف می‌کنیم. حداقل نسخه iOS پشتیبانی‌شده، iOS 14 خواهد بود که از ژوئن ۲۰۲۳ آغاز می‌شود. مشتریان باید قبل از به‌روزرسانی، با تغییر پرچم حداقل نسخه پشتیبانی‌شده در کد خود، خود را برای این به‌روزرسانی آماده کنند.

نسخه ۱.۰.۶ (۲۴ مارس ۲۰۲۲)

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

نسخه ۱.۰ (۷ دسامبر ۲۰۲۱)

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

تغییرات API

تغییرات احراز هویت

  • SDK برای پیاده‌سازی رابط AuthTokenFactory برای هر gRPC، getToken() را فراخوانی می‌کند. SDK این کار را با رهگیری فراخوانی‌های Fleet Engine و سپس اتصال JWT برگشتی از getToken() به هدر احراز هویت HTTP انجام می‌دهد. توجه داشته باشید که تولید توکن‌های معتبر به عهده شماست. یعنی توکن‌هایی که منقضی نشده‌اند و مجوزهای لازم را دارند.

  • GMTSAuthorization به GMTCAuthorization تغییر یافت.

  • GMTSServiceType حذف شد.

تغییرات در اطلاعات سفر و تماس‌های برگشتی

  • نام ویژگی سفر به‌روزرسانی شد: remainingDistanceOfActiveRouteInMeters .

  • به‌روزرسانی داده‌های ترافیک به GMTCTripModelSubscriber اضافه شد.

  • ویژگی remainingDistanceOfCurrentRouteInMeters اضافه شد.

  • ویژگی‌های جدیدی به GMTSTripPropertyFields اضافه شد:

    • GMTSTripPropertyFieldRemainingDistanceOfActiveRouteInMeters . (فاصله باقیمانده از مسیر فعال به متر)
    • GMTSTripPropertyFieldDistanceOfRemainingRouteInMetersGMTSTripPropertyFieldActiveRoute . (میدان ویژگی GMTSTripFieldفاصله از مسیر باقیمانده به متر)
    • GMTSTripPropertyFieldActiveRouteTrafficGMTSTripPropertyFieldRemainingRoute .
    • GMTSTripPropertyFieldRemainingRouteTraffic .

  • ویژگی‌های جدید remainingDistanceOfActiveRouteInMeters و distanceOfRemainingRouteInMeters در GMTSTrip اضافه شد.

  • RegisterSubscriber اکنون به طور خودکار نظارت بر سفر را برای یک tripModel آغاز می‌کند. UnregisterSubscriber زمانی که دیگر مشترکی وجود نداشته باشد، نظارت را متوقف می‌کند. ModelState و ModelOptions به ترتیب به state و options تغییر نام دادند. stop و start از هدر public حذف شدند.

    • نام modelState به state تغییر یافت.
    • نام modelOptions به options تغییر یافت.
    • start() و stop() در TripModel حذف شدند.

سایر تغییرات API

  • GMTSTripPreview و GMTSTripPreviewVehicleOptions حذف شدند.

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

    • GMTSPickupPointArea .
    • GMTSPickupPointGroup .
    • GMTSPickupPointMatch )

پشتیبانی از فریز کردن برای iOS 12 - 18 اکتبر 2021

در پاسخ به تغییرات در وابستگی‌های داخلی‌مان، ما پشتیبانی از iOS 12 را در نسخه اصلی آینده Consumer SDK برای iOS متوقف می‌کنیم.

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

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

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

نسخه ۰.۱۱.۰ (۳۰ سپتامبر ۲۰۲۱)

تغییرات

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

تغییرات API

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

  • برای مثال، GRC -> GMTC ، یا GRCMapView -> GMTCMapView .
  • برای مثال، GRS -> GMTS ، یا GRSTrip -> GMTSTrip .

به‌روزرسانی رابط برنامه‌نویسی کاربردی GMTSAuthorization

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

  • شمارشی GMTSServiceType به‌روزرسانی شد:

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

نسخه ۰.۱۰.۰ (۳ مه ۲۰۲۱)

تغییرات

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

تغییرات API

نسخه ۰.۹.۰ (۲۵ ژانویه ۲۰۲۱)

بهبودها

تغییرات API

نسخه ۰.۶.۷ (۲۳ مارس ۲۰۲۰)

بهبودها

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

نسخه ۰.۶.۳ (۱۶ دسامبر ۲۰۱۹)

تغییرات

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

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

نسخه ۰.۵.۴(۸۶.۰) (۷ آگوست ۲۰۱۹)

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

  • پشتیبانی از چند مقصد برای اشتراک‌گذاری سفر.

تغییرات 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;

  • یک نوع شمارشی نشانگر جدید به GRCMapViewMarkerType اضافه شد.

    • GRCMapViewMarkerTypeIntermediateDestination . (مکان میانی)

  • یک نوع نشانگر شمارشی قابل تنظیم جدید به 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;

بهبودها

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

  • فعال کردن خودکار دوربین هنگام رسیدن راننده به محل تحویل بار.

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

نسخه ۰.۴.۵(۲۸.۰) (۲۶ ژوئن ۲۰۱۹)

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

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

تغییرات API

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

رفع اشکالات

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

  • مشکلی که باعث می‌شد فراخوانی API isMarkerStyleOptionsCustomizedForType: for GRCCustomizableMarkerTypeSelectedDropoffPoint همیشه NO برگردانده شود، برطرف شد.

نسخه ۰.۴.۳ (۱۷ مه ۲۰۱۹)

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

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

تغییرات API

نوع نشانگر GRCMapView

ارزش قدیمی ارزش جدید
GRCMapViewMarkerTypeSelectedPickup GRCMapViewMarkerTypeSelectedPickupPoint
GRCMapViewMarkerTypeSelectedDropoff GRCMapViewMarkerTypeSelectedDropoffPoint
GRCMapViewMarkerTypePickupCandidate GRCMapViewMarkerTypeSuggestedPickupPoint
GRCMapViewMarkerTypeHighlightedPickupPoint
GRCMapViewMarkerTypeTripPreviewPickupPoint
GRCMapViewMarkerTypeTripPreviewDropoffPoint
GRCMapViewMarkerTypeTripPickupPoint
GRCMapViewMarkerTypeTripDropoffPoint

نمای نقشه GRCM

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

پروتکل GRCTripServiceSubscriber

ارزش قدیمی ارزش جدید
tripService:didUpdateTripRoute: tripService:didUpdateActiveRoute:
tripService:didUpdateRemainingDistance tripService:didUpdateActiveRouteRemainingDistance
tripService:didUpdateRemainingWaypoints

نوع پلی‌لاین GRC

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

گزینه‌های سبک پلی‌لاین GRC

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

جی آر اس تریپ

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

بهبودها

  • کاهش مصرف شبکه برای اشتراک‌گذاری سفر.
  • کاندیدای انتخاب شده برای تحویل، اکنون هایلایت شده است.
  • سازگار با Maps SDK نسخه ۳.۱.۰

رفع اشکالات

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