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

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

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

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

• إمكانية التوافق مع حِزم تطوير البرامج (SDK) للسائقين والمستهلكين بحيث يمكن إنشاؤها في التطبيق نفسه
• يتوافق مع مدير الحزم Swift لحِزم تطوير البرامج (SDK) للسائقين والمستهلكين.

الإصدار 3.2.0 (كانون الأول/ديسمبر 2023)

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

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

منهي العمل به

• تم إيقاف ميزة "[GMTCMapView initWithCoder]" نهائيًا في GMTCMapView.

الإصدار 3.1.1 (تشرين الأول/أكتوبر 2023)

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

• إصلاح الخطأ المتمثل في عدم طلب طرق GMSMapViewDelegate.

الإصدار 3.1.0 (أيلول/سبتمبر 2023)

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

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

إعلان

إيقاف مؤقت على أجهزة iOS 14 حتى 15 أيار (مايو) 2023

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

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

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

الإصدار 0.11.0 (30 سبتمبر 2021)

التغييرات

• تمت إضافة ميزة "رصد الأعطال أثناء إعداد حزمة تطوير البرامج (SDK)". يمكنك أيضًا إيقاف هذه الميزة باستخدام واجهة برمجة التطبيقات setAbnormalTerminationReportingEnabled: على GMTCServices.

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

تم تعديل بادئة الاسم لجميع الصفوف:

• GRC -> GMTC، مثل GRCMapView -> GRCMapView.
• GRS -> GMTS، مثل GRSTrip -> GMTSTrip.

تم تعديل واجهة برمجة تطبيقات GMTSUsage

• تمت إضافة المفتاح الجديد kGMTSAuthorizationContextKeyTaskID لتحديد معرّف المهمة في authorizationContext عند استدعاء fetchAuthTokenForServiceType:authorizationContext:completion:.

• تم تعديل تعداد GMTSServiceType:

  القيمة القديمة	القيمة الجديدة
  GMTSServiceTypeUnknown	GMTSServiceTypeUnspecified
  GMTSServiceTypeTripService
  GMTSServiceTypeVehicleService	GMTSServiceTypeVehicle
  GMTSServiceTypeTerminalPointService
  	GMTSServiceTypeTask

الإصدار 0.10.0 (3 أيار/مايو 2021)

التغييرات

دعم تم إيقافه نهائيًا لنظام التشغيل iOS 10.x. الإصدار الأدنى المتوافق مع نظام التشغيل 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.
• تم تحسين تتبُّع المركبات خارج المسار (يتطلب ذلك الإصدار 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.

الإصدار 0.4.3 (17 أيار/مايو 2019)

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

• إتاحة ميزة "المشاركة في الرحلة" للمستخدمين
• أصبحت ميزة "مشاركة الرحلات" الآن توفّر معدّل الإبلاغ الديناميكي عن الموقع الجغرافي للمركبة.

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

GRCMapViewMarkerType

القيمة القديمة	القيمة الجديدة
GRCMapViewMarkerTypeSelectedPickup	GRCMapViewMarkerTypeSelectedPickupPoint
GRCMapViewMarkerTypeSelectedDropoff	GRCMapViewMarkerTypeSelectedDropoffPoint
GRCMapViewMarkerTypePickupCandidate	GRCMapViewMarkerTypeSuggestedPickupPoint
	GRCMapViewMarkerTypeHighlightedPickupPoint
	GRCMapViewMarkerTypeTripPreviewPickupPoint
	GRCMapViewMarkerTypeTripPreviewDropoffPoint
	GRCMapViewMarkerTypeTripPickupPoint
	GRCMapViewMarkerTypeTripDropoffPoint

GRCMapView

القيمة القديمة	القيمة الجديدة
	redrawRidesharingOverlays

بروتوكول GRCTripService subscription

ملاحظة: في حال عدم استبدال هذه الطرق، لن تتسبب أداة التحويل البرمجي في حدوث أي أخطاء.

القيمة القديمة	القيمة الجديدة
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

التحسينات

• استهلاك أقل للشبكة من أجل مشاركة الرحلة.
• تم الآن تمييز العنصر المحفّز لعرض الإعلان الذي تم اختياره لاستلام الطلب.
• متوافقة مع "حزمة تطوير البرامج بالاستناد إلى البيانات" في "خرائط Google" الإصدار 3.1.0

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

• تم إصلاح المشكلة المتمثلة في عدم استجابة العلامات للنقر للمرة الثانية.
• تم إصلاح مشكلة كانت تسبب أحيانًا حدود كاميرا MapsView في عرض إطار عرض غير متوقع في وقت البدء، بعد حجز الرحلة.
• تم إصلاح مشكلة في واجهة برمجة التطبيقات لإصدار حِزم تطوير البرامج (SDK).