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

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

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

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

إشعار

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

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

إنّ إصدارات حزمة Consumer 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 (تمّ التغيير)

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

  • GMTSTerminalPoint
  • GMTSTerminalPointAccessPoint
  • GMTSTerminalPointTravelMode
  • GMTSTerminalPointsVehicleSearchPreference
  • GMTSTravelModeETA

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

منهي العمل به

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

إشعار

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

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

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

لن تتوافق حزمة تطوير البرامج Consumer 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 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.

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

• تم طرحه GRCMutableMarkerStyleOptions لتسهيل تخصيص علامة مشاركة الرحلة.

• تمّ إدخال tripModel:didUpdateRemainingRoute: وtripModel:didUpdateRemainingRouteDistance: في بروتوكول GRCTripModelSubscriber، لطلبات إعادة الاتصال لتعديل الرحلة عند تعديل المسار المتبقّي أو المسافة.

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

التحسينات

• يقدّم هذا الإصدار الخطوط المتعددة المراعية للزحام لمشاركة الرحلة.

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

• تمّت إضافة GRCMutablePolylineStyleOptions لتخصيص الخطوط المتعددة، والتي يمكن استخدامها لتفعيل عرض الخطوط المتعددة للزيارات من أجل مشاركة الرحلة.
• تمت إضافة طلب إعادة الاتصال لتعديل بيانات حركة المرور في GRCTripModelSubscriber:
  • tripModel:didUpdateActiveRouteTraffic:
• تم طرحها GRSTrafficData.
• تمت إضافة موقع إلكتروني جديد إلى GRSTripWaypoint للوصول إلى بيانات الزيارات:
  • trafficData
• تمت إضافة طريقة جديدة في GRSTrip للوصول إلى بيانات الزيارات:
  • activeRouteTraffic
  • remainingRouteTraffic

الإصدار 0.6.7 (23 آذار/مارس 2020)

التحسينات

• لا يتم عرض المسار المتعدد الأضلاع عندما تكون حالة الرحلة هي ARRIVED_AT_PICKUP.
• تم تحسين ميزة تتبُّع المركبات التي تخرج عن المسار (تتطلب DriverSDK 1.15):
  • لا تُعيد ميزة تتبُّع المركبات وضع المركبة إلى المسار عندما تتجاوز المركبة نقطة الاستلام.
  • تتيح ميزة تتبُّع المركبات عرض المركبة خارج الطريق، على سبيل المثال، في مواقف السيارات غير المُحدَّدة.
• لم يعُد يتم فرض مسار قديم على رموز المركبات عندما لا تتطابق وجهة السائق مع الوجهة في 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.

الإصدار 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 من حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google"

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

• تم إصلاح مشكلة عدم استجابة العلامات للنقر عليها للمرة الثانية.
• تم إصلاح مشكلة ظهور إطار عرض غير متوقّع في وقت البداية بعد حجز رحلة في حدود كاميرا mapView.
• تم إصلاح مشكلة في واجهة برمجة التطبيقات SDK Version API.