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

يحتوي هذا القسم على ملاحظات إصدار حزمة SDK للمستهلك على أجهزة iOS.

الإصدار 11.1.0 (سبتمبر 2026)

  • Version bump for the 11.1.0 release.
  • تم إصلاح أخطاء بسيطة وتحديث التبعيات الداخلية.

الإصدار 10.10.1 (مايو 2026)

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

الإصدار 10.10 (مارس 2026)

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

الإصدار 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 إلى 9.2.
  • يتيح استخدام ميزة تصميم الخرائط باستخدام السحابة الإلكترونية.
  • تتيح للمستخدمين استرداد حالة "الموقع الجغرافي للمركبة" أثناء الرحلة.
  • تم إصلاح مشكلة نادرة تؤدي إلى اختفاء الخطوط المتعدّدة.

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

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

  • تتوافق مع الإصدار 9.0 من حزم تطوير البرامج (SDK) لنظام التشغيل iOS من Geo.
  • تم إيقاف دعم الإصدار 14 من نظام التشغيل iOS نهائيًا. أصبح الحد الأدنى لإصدار iOS الآن هو 15.0.
  • يتضمّن هذا الإصدار ملف ‎ .xcprivacy لدعم ميزة "بيانات الخصوصية" (Privacy Manifests) من 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.

الإصدار 3.1.0 (سبتمبر 2023)

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

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

إشعار

إيقاف توفير الدعم لنظام التشغيل iOS 14 اعتبارًا من 15 مايو 2023

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

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

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

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

الإصدار 2.2.0 (فبراير 2023)

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

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

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

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

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

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

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

  • تمت إزالة "خدمة نقطة النهاية" (Terminal Point Service)، والتي تشمل ما يلي:

    • GMTSTerminalPoint
    • GMTSTerminalPointAccessPoint
    • GMTSTerminalPointTravelMode
    • GMTSTerminalPointsVehicleSearchPreference
    • GMTSTravelModeETA
  • تم الآن إيقاف دعم الإصدار iOS 12. الحد الأدنى لإصدار iOS هو الآن 13.0.

منهي العمل به

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

إشعار

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

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

إيقاف الدعم لنظام التشغيل iOS 12 في 18 أكتوبر 2021

استجابةً للتغييرات في التبعيات الداخلية، سنوقف دعم iOS 12 في رقم الإصدار الرئيسي القادم من حزمة تطوير البرامج (SDK) للمستهلك على iOS.

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

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

احرص على تحديد إصدار في تبعيات إصدار تطبيقك للتحكّم في وقت رفع الحد الأدنى لإصدار نظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك. يمكنك الاطّلاع على أمثلة على تحديد إصدار في مستندات حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط 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)

التحسينات

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

الإصدار 0.6.7 (‫23 مارس 2020)

التحسينات

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

الإصدار 0.6.3 (‫16 ديسمبر 2019)

التغييرات

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

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

الإصدار 0.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;

التحسينات

  • تعديل جميع الأوقات المقدّرة المتبقية للوصول إلى النقاط على المسار عند تغيير الوقت المقدّر للوصول إلى النقطة الأولى على المسار في القائمة

  • فرض إعادة توسيط الكاميرا تلقائيًا عند وصول السائق إلى نقطة الالتقاء

  • ستشمل حدود الكاميرا كلاً من موقعَي الاستلام والتسليم بعد حجز الرحلة وقبل توفّر أي موقع جغرافي لمركبة مطابقة.

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