یادداشت‌های انتشار کیت توسعه نرم‌افزار مصرف‌کننده برای iOS

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

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

  • ارتقای نسخه برای انتشار ۱۱.۱.۰.
  • رفع اشکالات جزئی و به‌روزرسانی وابستگی‌های داخلی.

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

  • [رفع اشکال] رفع پس‌رفتگی که در آن اگر فیلدهای خاصی در پاسخ وجود نداشت، به‌روزرسانی‌های سفر ناموفق بود.

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

  • [رفع اشکال] تغییراتی ایجاد شد تا ConsumerSDK بتواند درصورت قطع شدن شبکه درطول سفر، سریع‌تر بازیابی شود.
  • کیت توسعه نرم‌افزار مصرف‌کننده با Xcode 26 ساخته شده است.

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

تغییر کرد

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

تغییرات میانای برنامه‌سازی کاربردی

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

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

تغییر کرد

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

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

تغییر کرد

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

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

تغییر کرد

  • از کیت‌های توسعه نرم‌افزار Geo iOS نسخه ۹.۰ پشتیبانی می‌کند.
  • پشتیبانی از iOS 14 اکنون متوقف شده است. حداقل نسخه iOS اکنون ۱۵.۰ است.
  • این نسخه شامل فایل xcprivacy .برای پشتیبانی از «مانیفست‌های حریم خصوصی Apple» است.
  • شامل اصلاح احتمالی برای خرابی نادر مربوط به گزارش‌ها است.

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

تغییر کرد

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

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

تغییر کرد

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

منسوخ

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

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

تغییر کرد

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

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

تغییر کرد

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

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

تغییر کرد

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

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

تغییر کرد

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

اعلامیه

توقف پشتیبانی از iOS 14 - ‏۱۵ مه ۲۰۲۳

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

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

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

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

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

تغییر کرد

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

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

تغییر کرد

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

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

تغییر کرد

  • «سرویس پایانه فروش» را که شامل موارد زیر است برداشته‌ایم:

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

منسوخ

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

اعلامیه

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

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

رفع اشکال‌های داخلی.

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

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

تغییرات میانای برنامه‌سازی کاربردی

تغییرات اصالت‌سنجی

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

تغییرات دیگر میانای برنامه‌سازی کاربردی

  • ‫GMTSTripPreview و GMTSTripPreviewVehicleOptions حذف شد.

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

    • GMTSPickupPointArea.
    • GMTSPickupPointGroup.
    • GMTSPickupPointMatch.

توقف پشتیبانی از iOS 12 - ‏۱۸ اکتبر ۲۰۲۱

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

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

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

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

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

تغییرات

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

تغییرات میانای برنامه‌سازی کاربردی

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

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

GMTSAuthorization API به‌روز شد

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

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

    مقدار قبلی مقدار جدید
    GMTSServiceTypeUnknown GMTSServiceTypeUnspecified
    GMTSServiceTypeTripService
    GMTSServiceTypeVehicleService GMTSServiceTypeVehicle
    GMTSServiceTypeTerminalPointService
    GMTSServiceTypeTask

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

تغییرات

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

تغییرات میانای برنامه‌سازی کاربردی

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

بهبودها

تغییرات میانای برنامه‌سازی کاربردی

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

بهبودها

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

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

تغییرات

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

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

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

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

  • پشتیبانی از چند مقصد برای «هم‌رسانی سفر».

تغییرات میانای برنامه‌سازی کاربردی

  • وضعیت سفر جدیدی به GRSTripStatus اضافه شد.

    • GRSTripStatusEnrouteToIntermediateDestination.
    • GRSTripStatusArrivedAtIntermediateDestination.
  • دارایی‌های جدیدی به GRSTrip اضافه شد.

    • intermediateDestinations.
    • intermediateDestinationIndex.
  • میانای برنامه‌سازی کاربردی فراخوان جدیدی به 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
  • چهار میانای برنامه‌سازی کاربردی callback مربوط به mapView از GRCMapView حذف شد.

    • -(void)mapViewDidStartWaitingForPickup:(GRCMapView *)mapview;
    • -(void)mapViewDidUpdateDueToDriverArrived:(GRCMapView *)mapview;
    • -(void)mapViewDidStartTripEnroute:(GRCMapView *)mapview;
    • -(void)mapViewDidCompleteTrip:(GRCMapView *)mapview;
  • میانای برنامه‌سازی کاربردی فراخوان جدیدی به GRCMapView اضافه شد.

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

بهبودها

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

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

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

v0.4.5(28.0) (June 26, 2019)

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

  • پشتیبانی از سفر اشتراکی برای هم‌رسانی مسیر.

تغییرات میانای برنامه‌سازی کاربردی

  • فیلد type از GRSTerminalLocation برداشته شد.

رفع اشکال‌ها

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

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

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

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

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

تغییرات میانای برنامه‌سازی کاربردی

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 نسخه ۳.۱.۰

رفع اشکال‌ها

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