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

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

الإصدار 11.1.1 (نوفمبر 2026)

  • تم تعديل حزمة Swift لاستخدام أحدث تصحيح لحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS 11.1.
  • لا حاجة إلى إجراء أي تغييرات على الرموز البرمجية. ملف SDK الثنائي هو نفسه الإصدار 11.1.0، وتواصل حزمة SDK الإبلاغ عن الإصدار 11.1.0 في وقت التشغيل.

الإصدار 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 (يوليو 2024)

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

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

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

إشعار

إيقاف إتاحة الإصدار 14 من نظام التشغيل iOS - ‏15 مايو 2023

وفقًا لسياسة دعم إصدارات أنظمة تشغيل الأجهزة الجوّالة، سنوقف دعم الإصدار 14 من نظام التشغيل iOS في رقم الإصدار الرئيسي القادم من حزمة تطوير البرامج (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.

إشعار

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