حزمة تطوير البرامج (SDK) للمستهلك لملاحظات الإصدار لنظام التشغيل iOS

يحتوي هذا القسم على ملاحظات الإصدار الخاصة بـ Consumer SDK لنظام التشغيل iOS.

الإصدار 10.0.0 (يونيو 2025)

Changed (تمّ التغيير)

  • تم الآن إيقاف دعم نظام التشغيل iOS 15. أصبح الحد الأدنى لإصدار iOS هو 16.0.

التغييرات في واجهة برمجة التطبيقات

  • تضيف هذه السمة الفئة GMTSVehicleLocationOptions، حيث يمكنك استخدام السمة serverTime لتحديد الوقت الذي تلقّى فيه Fleet Engine آخر تعديل على الموقع الجغرافي.
  • يضيف أداة تهيئة initWithOptions<GMTSVehicleLocationOptions> في GMTSVehicleLocation
  • إيقاف استخدام أداة إنشاء initWithLatLng:GMTSLatLng في GMTSVehicleLocation استخدِم أداة التهيئة initWithOptions:<GMTSVehicleLocationOptions> بدلاً من ذلك.

الإصدار 9.2.1 (أبريل 2025)

Changed (تمّ التغيير)

  • إصلاح الخطأ الناتج عن الرموز غير المحدّدة

الإصدار 9.2 (يناير 2025)

Changed (تمّ التغيير)

الإصدار 9.0 (يوليو 2024)

Changed (تمّ التغيير)

  • يتوافق مع الإصدار 9.0 من حِزم تطوير البرامج (SDK) لنظام التشغيل iOS من Geo.
  • تم الآن إيقاف دعم نظام التشغيل iOS 14. أصبح الحد الأدنى لإصدار iOS هو 15.0.
  • يتضمّن هذا الإصدار ملف ‎ .xcprivacy لدعم "بيانات الخصوصية" من Apple.
  • يتضمّن حلاً محتملاً لتعطُّل نادر مرتبط بالسجلات.

‫3.3.0 (مارس 2024)

Changed (تمّ التغيير)

  • يتيح توافق حِزم تطوير البرامج (SDK) الخاصة بالسائقين والمستهلكين، ما يتيح إنشاء التطبيقين في تطبيق واحد.
  • تتوافق مع أداة Swift Package Manager لحِزم تطوير البرامج (SDK) الخاصة بالسائقين والمستهلكين.

‫3.2.0 (ديسمبر 2023)

Changed (تمّ التغيير)

  • تم إصلاح الأخطاء وإجراء تعديلات على المستندات.

منهي العمل به

  • تم إيقاف [GMTCMapView initWithCoder] نهائيًا في GMTCMapView.

‫3.1.1 (أكتوبر 2023)

Changed (تمّ التغيير)

  • إصلاح الخطأ الذي يتسبّب في عدم استدعاء طرق GMSMapViewDelegate

‫v3.1.0 (سبتمبر 2023)

Changed (تمّ التغيير)

  • CocoaPod الخاص بحزمة Consumer SDK هو الآن .xcframework الذي يتيح للمطوّرين إنشاء إصدارات متوافقة مع الأجهزة والمحاكي على أجهزة Mac المستندة إلى معالجات Intel وApple Silicon.

الإصدار 3.0.1 (أغسطس 2023)

Changed (تمّ التغيير)

  • إصلاح الخطأ الناتج عن الرموز غير المحدّدة

‫3.0.0 (مايو 2023)

Changed (تمّ التغيير)

  • تزيل هذه السمة أداة التهيئة المتوقّفة نهائيًا في GMTCMapView.
  • إصلاح عمليات جلب الرمز المميز لمواصلة المصادقة بعد إزالة جميع المشتركين من GMTCTripModel
  • تم الآن إيقاف إتاحة التطبيق لنظام التشغيل iOS 13. أصبح الحد الأدنى لإصدار iOS هو 14.0.
  • الحد الأدنى الجديد للإصدار المتوافق من Xcode هو 14.0. يُرجى الاطّلاع على عمليات الإيقاف النهائي في ملاحظات الإصدار الخاصة بالإصدار 14 من Xcode بشأن إيقاف إمكانية إنشاء التطبيقات باستخدام رمز Bitcode.
  • وفقًا لسياسة توافق إصدارات نظام التشغيل للأجهزة الجوّالة، سنتوقف عن توفير الدعم لنظام التشغيل iOS 13 اعتبارًا من الإصدار 3.0.0 من حزمة Consumer SDK لنظام التشغيل iOS. الحد الأدنى الجديد لنظام التشغيل المتوافق هو iOS 14. ستواصل إصدارات حزمة SDK الأقدم توفير الدعم لنظام التشغيل iOS 13. إذا لم تحدّد رقم إصدار في العناصر التابعة، سيحمّل بيئة التطوير المتكاملة أحدث إصدار من حزمة تطوير البرامج (SDK)، ولن تتوافق الإصدارات الجديدة من تطبيقك مع نظام التشغيل iOS 13. حدِّد إصدارًا من Consumer SDK لنظام التشغيل iOS في تبعيات الإصدار لتطبيقك من أجل التحكّم في الوقت الذي ترفع فيه الحد الأدنى من نظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.

إشعار

إيقاف دعم الإصدار 14 من نظام التشغيل iOS نهائيًا - 15 أيار (مايو) 2023

وفقًا لسياسة توافق إصدارات نظام التشغيل على الأجهزة الجوّالة، سنوقف إتاحة الإصدار 14 من نظام التشغيل iOS في إصدار رئيسي قادم من حزمة Consumer SDK لنظام التشغيل iOS.

ستتوافق إصدارات Consumer SDK لنظام التشغيل iOS التي تم طرحها اعتبارًا من الربع الثاني من عام 2024 مع الإصدار 15 من نظام التشغيل iOS كحد أدنى. ستواصل إصدارات حزمة SDK الأقدم توفير الدعم لنظام التشغيل iOS 14.

إذا لم تحدّد التبعيات رقم إصدار، سيحمّل بيئة التطوير المتكاملة أحدث إصدار من حزمة SDK، ولن تتوافق الإصدارات الجديدة من تطبيقك مع نظام التشغيل iOS 14.

حدِّد إصدارًا من Consumer SDK لنظام التشغيل iOS في ملحقات الإصدار الخاصة بتطبيقك للتحكّم في الوقت الذي ترفع فيه الحد الأدنى من نظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.

‫v2.2.0 (فبراير 2023)

Changed (تمّ التغيير)

  • تعديل عنوان URL الخاص بالأحكام والشروط في ملفات العناوين إلى الرابط الصحيح، وإصلاح المشاكل البسيطة الأخرى المتعلّقة بعلامات الترقيم
  • تم إصلاح أخطاء إملائية وعلامات ترقيم وأخطاء بسيطة أخرى في المستندات.

الإصدار 2.1.0 (12 أيلول/سبتمبر 2022)

Changed (تمّ التغيير)

  • تم إصلاح الأخطاء وإجراء تعديلات على المستندات.

الإصدار 2.0.0 (‫18 يوليو 2022)

Changed (تمّ التغيير)

  • تمت إزالة خدمة "نقطة النهاية" التي تتضمّن ما يلي:

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

  • تم الآن إيقاف دعم نظام التشغيل iOS 12. أصبح الحد الأدنى لإصدار iOS هو 13.0.

منهي العمل به

  • تم إيقاف أدوات التهيئة نهائيًا في الفئة العامة GMTCMapView.

إشعار

سنوقف نهائيًا إتاحة الإصدار 13 من نظام التشغيل iOS في التحديثات الرئيسية لعام 2023 من حزمة تطوير البرامج (SDK) المخصّصة للمستهلكين على نظام التشغيل iOS. سيكون الحد الأدنى لإصدار iOS المتوافق هو iOS 14، وذلك اعتبارًا من يونيو 2023. على العملاء الاستعداد من خلال تغيير علامة الحد الأدنى من إصدار الدعم في الرمز قبل التحديث.

‫1.0.6 (24 مارس 2022)

إصلاحات أخطاء داخلية.

الإصدار 1.0 (‫7 ديسمبر 2021)

الحد الأدنى لإصدار iOS المتوافق مع هذا الإصدار هو 12.0.

التغييرات في واجهة برمجة التطبيقات

تغييرات في المصادقة

  • تطلب حزمة 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.

التغييرات الأخرى في واجهة برمجة التطبيقات

  • تمت إزالة GMTSTripPreview وGMTSTripPreviewVehicleOptions.

  • تمت إزالة خدمة اختيار نقطة استلام الطلب، والتي تشمل:

    • GMTSPickupPointArea.
    • GMTSPickupPointGroup.
    • GMTSPickupPointMatch.

إيقاف دعم الإصدار 12 من نظام التشغيل iOS نهائيًا - 18 تشرين الأول (أكتوبر) 2021

استجابةً للتغييرات في التبعيات الداخلية، سنوقف توافق الإصدار 12 من نظام التشغيل iOS مع إصدار رئيسي قادم من حزمة Consumer SDK لنظام التشغيل iOS.

لن تتوافق حزمة تطوير البرامج (SDK) المخصّصة للمستهلكين لنظام التشغيل iOS الإصدار 2.0 أو إصدار أحدث إلا مع الأجهزة التي تعمل بالإصدار 13 من نظام التشغيل iOS أو إصدار أحدث. ستظل إصدارات حزمة SDK السابقة متوافقة مع نظام التشغيل iOS 12.

إذا لم تحدّد التبعيات في CocoaPods أو Carthage رقم إصدار، سيحمّل Xcode أحدث إصدار ولن تتوافق الإصدارات الجديدة من تطبيقك مع نظام التشغيل iOS 12.

احرص على تحديد إصدار في تبعيات الإصدار لتطبيقك من أجل التحكّم في موعد رفع الحد الأدنى لنظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك. يمكنك الاطّلاع على أمثلة لتحديد إصدار في مستندات حزمة تطوير البرامج (SDK) لخدمة "خرائط Google" لنظام التشغيل iOS. اطّلِع على الإرشادات المتعلّقة بأفضل الممارسات لصيانة التطبيقات.

الإصدار 0.11.0 (‫30 سبتمبر 2021)

التغييرات

  • تمت إضافة ميزة رصد الأعطال أثناء عملية إعداد حزمة تطوير البرامج (SDK). يتوفّر أيضًا خيار لإيقاف هذه الميزة من خلال استخدام واجهة برمجة التطبيقات setAbnormalTerminationReportingEnabled: على GMTCServices.

التغييرات في واجهة برمجة التطبيقات

تم تعديل بادئة الاسم لجميع الفئات:

  • GRC -> GMTC، على سبيل المثال، GRCMapView -> GMTCMapView.
  • GRS -> GMTS، على سبيل المثال، GRSTrip -> GMTSTrip

تعديل واجهة برمجة التطبيقات GMTSAuthorization

  • تمت إضافة المفتاح الجديد kGMTSAuthorizationContextKeyTaskID لتحديد معرّف المهمة في authorizationContext عند استدعاء fetchAuthTokenForServiceType:authorizationContext:completion:.

  • تم تعديل تعداد GMTSServiceType:

    القيمة القديمة القيمة الجديدة
    GMTSServiceTypeUnknown GMTSServiceTypeUnspecified
    GMTSServiceTypeTripService
    GMTSServiceTypeVehicleService GMTSServiceTypeVehicle
    GMTSServiceTypeTerminalPointService
    GMTSServiceTypeTask

الإصدار 0.10.0 (3 أيار (مايو) 2021)

التغييرات

تم إيقاف دعم الإصدار 10.x من نظام التشغيل iOS. أصبح الحد الأدنى لإصدار iOS المتوافق هو 11.0.

التغييرات في واجهة برمجة التطبيقات

الإصدار 0.9.0 (25 كانون الثاني (يناير) 2021)

التحسينات

التغييرات في واجهة برمجة التطبيقات

‫v0.6.7 (23 مارس 2020)

التحسينات

  • لا يظهر خط متعدد الأضلاع للمسار عندما تكون حالة الرحلة ARRIVED_AT_PICKUP.
  • تم تحسين تتبُّع المركبات التي تسلك طرقًا غير محدّدة (يتطلّب الإصدار 1.15 من DriverSDK):
    • لا يتم محاذاة المركبة مع المسار عندما تتجاوز نقطة الاستلام.
    • تتيح ميزة تتبُّع المركبة عرض المركبة خارج الطريق، مثلاً في مواقف السيارات غير المحدّدة على الخريطة.
  • لم يعُد يتم فرض مسار قديم على رموز المركبات عندما لا يتطابق وجهة السائق مع الوجهة في Fleet Engine.
  • تم الآن إيقاف الردود القديمة على الرحلات.

الإصدار 0.6.3 (16 كانون الأول/ديسمبر 2019)

التغييرات

  • تمت إضافة سجلّات لوقت استجابة طلب الرحلة.

  • تمت إضافة سجلّات لأخطاء الردود المتعلقة بالرحلات.

‫v0.5.4(86.0) (7 أغسطس 2019)

الميزات الجديدة

  • إتاحة ميزة "مشاركة الرحلة" لوجهات متعددة

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة حالة رحلة جديدة إلى 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

  • تم حذف أربع واجهات برمجة تطبيقات لمعاودة الاتصال بـ 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) (26 يونيو 2019)

الميزات الجديدة

  • إتاحة ميزة "مشاركة الرحلة" في Carpool

التغييرات في واجهة برمجة التطبيقات

  • تمت إزالة الحقل type من GRSTerminalLocation.

إصلاح الأخطاء

  • لا يتم عرض الرسوم المتحركة للمسار الآن إلا عندما تكون أجزاء المسار متزامنة، ما يؤدي إلى تحسين تجربة المستخدم.

  • تم إصلاح المشكلة التي كانت تؤدي إلى أن يعرض طلب إلى واجهة برمجة التطبيقات isMarkerStyleOptionsCustomizedForType: بشأن GRCCustomizableMarkerTypeSelectedDropoffPoint دائمًا القيمة NO.

الإصدار 0.4.3 (17 أيار/مايو 2019)

الميزات الجديدة

  • إمكانية الرجوع إلى ميزة "مشاركة الرحلة"
  • تتيح ميزة "مشاركة الرحلة" الآن معدّل إبلاغ ديناميكي عن الموقع الجغرافي للمركبة.

التغييرات في واجهة برمجة التطبيقات

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

التحسينات

  • تقليل استهلاك الشبكة عند مشاركة الرحلات
  • تم الآن تمييز مرشّح الاستلام المحدّد.
  • متوافق مع الإصدار 3.1.0 من "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google"

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم استجابة العلامات للنقر للمرة الثانية.
  • تم إصلاح مشكلة كانت تؤدي أحيانًا إلى ظهور إطار عرض غير متوقّع في حدود كاميرا mapView في وقت البدء، وذلك بعد حجز رحلة.
  • تم إصلاح مشكلة في واجهة برمجة التطبيقات الخاصة بإصدار حزمة تطوير البرامج (SDK).