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

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

‫v11.1.0 (سبتمبر 2026)

  • زيادة رقم الإصدار إلى 11.1.0.
  • إصلاحات أخطاء بسيطة وتحديثات للتبعيات الداخلية

‫v10.10.1 (مايو 2026)

  • [إصلاح خطأ] تم إصلاح مشكلة تراجع حيث كان من الممكن أن يتعذّر عرض آخر المعلومات عن الرحلة إذا كانت بعض الحقول غير متوفّرة في الرد.

‫10.10 (مارس 2026)

  • [إصلاح خطأ] تم إجراء تغييرات لمساعدة ConsumerSDK على استعادة الاتصال بسرعة أكبر في حال حدوث انقطاع في الشبكة أثناء الرحلة.
  • تم إنشاء حزمة SDK للمستهلك باستخدام Xcode 26.

‫10.0.0 (يونيو 2025)

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

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

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

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

‫9.2.1 (أبريل 2025)

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

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

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

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

‫v9.0 (يوليو 2024)

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

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

الإصدار 3.3.0 (مارس 2024)

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

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

‫v3.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. يُرجى الاطّلاع على عمليات الإيقاف النهائي في ملاحظات إصدار Xcode 14 بشأن إيقاف إمكانية إنشاء التطبيقات باستخدام رمز Bitcode.
  • وفقًا لسياسة توافق إصدارات نظام التشغيل للأجهزة الجوّالة، سنتوقف عن توفير الدعم لنظام التشغيل iOS 13 اعتبارًا من الإصدار 3.0.0 من حزمة تطوير البرامج (SDK) للمستهلكين على iOS. الحد الأدنى الجديد لنظام التشغيل المتوافق هو iOS 14. ستواصل إصدارات حزمة تطوير البرامج (SDK) السابقة توفير الدعم لنظام التشغيل iOS 13. إذا لم تحدّد التبعيات رقم إصدار، سيحمّل بيئة التطوير المتكاملة أحدث إصدار من حزمة SDK، ولن تتوافق الإصدارات الجديدة من تطبيقك مع نظام التشغيل iOS 13. حدِّد إصدارًا من حزمة Consumer SDK لنظام التشغيل iOS في تبعيات الإصدار لتطبيقك من أجل التحكّم في الوقت الذي ترفع فيه الحد الأدنى من نظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.

إشعار

إيقاف إمكانية استخدام الإصدار 14 من نظام التشغيل iOS نهائيًا - 15 مايو 2023

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

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

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

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

‫2.2.0 (فبراير 2023)

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

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

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

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

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

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

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

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

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA

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

منهي العمل به

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

إشعار

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

‫v1.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

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

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

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

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

‫v0.11.0 (30 سبتمبر 2021)

التغييرات

  • تمت إضافة ميزة رصد الأعطال أثناء عملية تهيئة حزمة تطوير البرامج (SDK). يتوفّر أيضًا خيار لإيقاف هذه الميزة من خلال استخدام واجهة برمجة التطبيقات 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

الإصدار 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)

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

  • إتاحة مشاركة الرحلة مع مجموعة من الأشخاص

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

  • تمت إزالة الحقل "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).