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

يحتوي هذا القسم على ملاحظات الإصدار لحزمة تطوير البرامج (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 for Driver and Consumer SDKs.

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

إشعار

تجميد البيانات لنظام التشغيل iOS من 14 إلى 15 أيار (مايو) 2023

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

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

إذا لم تحدد التبعيات رقم الإصدار، فسيحمّل بيئة التطوير المتكاملة (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.

إشعار

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

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

تم تحديث واجهة برمجة التطبيقات GMTS مفعَّلة

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

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

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