ملاحظات حول إصدار حزمة تطوير برامج برامج تشغيل Android

يحتوي هذا القسم على ملاحظات حول إصدار Driver SDK لنظام التشغيل Android.

راجِع أيضًا:

• ملاحظات إصدار حزمة تطوير البرامج (SDK) للإصدار الأول من Navigation
• ملاحظات إصدار الإصدار 2 والإصدارات الأحدث من Navigation SDK

‫7.1.0 (‫14 مايو 2026)

تغييرات التبعية والإعدادات

• تمت إضافة تبعيات Jetpack DataStore: androidx.datastore:datastore-core الإصدار 1.1.7 وandroidx.datastore:datastore-guava الإصدار 1.2.0.

• تمت ترقية إصدار تبعية Kotlin إلى الإصدار 2.3.0.

• تمت ترقية إصدار "المكوّن الإضافي لنظام Gradle المتوافق مع Android" إلى 8.13.2.

• تمت ترقية إصدار Gradle إلى 8.13.

• تمت ترقية إصدار مكتبة Desugar إلى 2.1.5.

• تم توسيع نطاق إصدارات حزمة تطوير البرامج للتنقّل المتوافقة من [7.0, 7.3) إلى [7.0, 8.0).

‫v7.0.0 (‫5 ديسمبر 2025)

تغييرات التبعية والإعدادات

• تمت ترقية minSdkVersion إلى الإصدار 26 من واجهة برمجة التطبيقات.

• تمت ترقية targetSdkVersion إلى الإصدار 36 من واجهة برمجة التطبيقات.

• تم تعديل إصدارات "حزمة تطوير البرامج للتنقّل" المتوافقة لتشمل الإصدارات التي تبدأ من الإصدار 7.0.0.

‫v6.99.0 (‫5 ديسمبر 2025)

• تحسينات داخلية

إعلان: تجميد دعم مستوى واجهة برمجة التطبيقات 23 و24 و25

وفقًا لسياسة توافق إصدارات نظام التشغيل على الأجهزة الجوّالة، سنتوقف عن توفير الدعم لنظامَي التشغيل Android 6 و7 (المستوى 23 و24 و25 من واجهة برمجة التطبيقات) في الإصدارات الرئيسية القادمة من Driver SDK لنظام التشغيل Android.

بدءًا من الإصدار 7.0.0، ستتوافق حزمة تطوير البرامج (SDK) لنظام التشغيل Android مع الإصدار 8 من نظام التشغيل Android (المستوى 26 من واجهة برمجة التطبيقات) كحد أدنى. ستواصل إصدارات حزمة SDK الأقدم توفير الدعم لنظامَي التشغيل Android 6 و7.

إذا لم تحدّد التبعيات رقم إصدار، سيحمّل بيئة التطوير المتكاملة أحدث إصدار من حزمة SDK، ولن تتوافق الإصدارات الجديدة من تطبيقك مع Android 6 و7.

حدِّد إصدارًا من Driver SDK لنظام التشغيل Android في تبعيات الإصدار لتطبيقك من أجل التحكّم في وقت رفع الحد الأدنى من نظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.

الإصدار 6.2.0 (‫18 يونيو 2025)

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

• تم إصلاح عُطل NullPointerException أثناء طلب DriverApi.createInstance() عند عدم توفير DriverStatusListener.

تغييرات التبعية والإعدادات

• بدءًا من الإصدار 6.2.0 من Driver SDK لنظام التشغيل Android، يجب أن يتم ترقية التطبيقات إلى الإصدار 2.1 من Kotlin.

• تم تعديل "حزمة تطوير البرامج للتنقّل" لتتوافق مع إصدارات محدّدة النطاق، بما في ذلك الإصدار 6.1.0 والإصدارات الأحدث.

الإصدار 6.1.0 (‫10 مارس 2025)

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

• تحسينات على تسجيل البيانات الداخلي

‫v5.99.1 (‫10 يناير 2025)

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

• تم إصلاح المشكلة التي كانت تتسبّب في تلقّي برامج التشغيل أخطاء gRPC بالرمز "INTERNAL" والرسالة "Panic! هذا خطأ" وصف عند تشغيل التطبيق لأول مرة بعد التثبيت.

‫6.0.0 (‫25 نوفمبر 2024)

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

• تم إصلاح المشكلة التي كانت تتسبّب في تلقّي برامج التشغيل أخطاء gRPC بالرمز "INTERNAL" و "Panic! هذا خطأ".
• تحسين داخلي للحدّ من أخطاء الاتصال عند تعديل الموقع الجغرافي، خاصةً عندما يبدّل الجهاز الشبكات. سيتم طرح هذه الميزة بشكل تدريجي (بدءًا من %0) بعد دمج الإصدار.

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

• تمت إزالة الواجهة المتوقّفة نهائيًا StatusListener.

تغييرات التبعية والإعدادات

• إزالة الاعتمادية على glide:cronet-integration في ملف POM.xml
• تم تعديل حزمة تطوير البرامج للتنقّل لتتوافق مع الإصدارات المتراوحة حتى الإصدار 5.x.
• بدءًا من الإصدار 6.0.0 من Driver SDK لنظام التشغيل Android، يجب أن ترقّي التطبيقات إلى Kotlin 2.0.
• أصبح targetSdk الآن هو المستوى 34 من واجهة برمجة التطبيقات. وهذا شرط يجب استيفاؤه في جميع التطبيقات التي سيتم نشرها على "متجر Google Play" اعتبارًا من أغسطس 2024. يُرجى الاطّلاع على مقالة استيفاء متطلبات مستوى واجهة برمجة التطبيقات المستهدَف في Google Play.

‫v5.99.0 (‫20 سبتمبر 2024)

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

• تم إصلاح المشكلة التي كانت تتسبّب في تلقّي برامج التشغيل أخطاء gRPC بالرمز "INTERNAL" و "Panic! هذا خطأ". سيتم طرح هذه الميزة بشكل تدريجي (بدءًا من %0) بعد دمج الإصدار.
• تحسين داخلي للحدّ من أخطاء الاتصال عند تعديل الموقع الجغرافي، خاصةً عندما يبدّل الجهاز الشبكات. سيتم طرح هذه الميزة بشكل تدريجي (بدءًا من %0) بعد دمج الإصدار.

تغييرات التبعية والإعدادات

• إزالة الاعتمادية على glide:cronet-integration في ملف POM.xml

‫v5.0.0 (‫12 سبتمبر 2023)

تغييرات التبعية والإعدادات

• تم تعديل حزمة تطوير البرامج للتنقّل إلى الإصدار 5.x.
• تمت ترقية minSdkVersion إلى المستوى 23 من واجهة برمجة التطبيقات.
• تمت ترقية إصدار Kotlin إلى 1.9.0.
• تمت إضافة تبعية إلى Room. * يجب أن تتضمّن التطبيقات التي تستخدم Driver SDK الآن targetSdkVersion من المستوى 31 لواجهة برمجة التطبيقات أو مستوى أحدث.
• يجب الآن تفعيل توافق مكتبة Java 8 في التطبيقات التي تستخدم Driver SDK. يمكنك الاطّلاع على https://developer.android.com/studio/write/java8-support للحصول على تعليمات حول التحديث.
• يجب نقل التطبيقات التي تستخدم Proguard أو Dexguard إلى R8. لمزيد من المعلومات، يُرجى الاطّلاع على الرابط https://developer.android.com/build/shrink-code.
• يجب تفعيل عملية إزالة التجميل اللغوي في التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) الخاصة ببرنامج التشغيل. راجِع https://developer.android.com/studio/write/java8-support#library-desugaring للحصول على التعليمات.

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

• تم إصلاح مشكلة في مزامنة disableLocationTracking.
• تم تقديم واجهة DriverStatusListener جديدة تعرض سببًا في تحديثات حالة الاستثناء.
• تم إصلاح مشكلة عدم تحرّك السائقين (متاحة بدءًا من الإصدار 4.99.0).

‫v4.99.0 (‫9 أغسطس 2023)

• توفير مجموعة من الإصدارات لتبعيات NavSDK ** يتوافق مع الإصدار 4.5.0 حتى الإصدار 5.0.0 (باستثناء الإصدار 5.0.0).
• منع انخفاض الوقت المقدَّر للوصول تلقائيًا عندما تكون المركبة متوقفة سيتم طرح هذا التغيير تدريجيًا كتجربة، لذا لن يظهر هذا التغيير في جميع التطبيقات في الوقت نفسه.

‫4.5.0 (12 مايو 2023)

• تعديل تبعية حزمة Navigation SDK إلى الإصدار 4.5 يُرجى العِلم أنّه تم تغيير أرقام تعريف المجموعة والعنصر في حزمة Navigation SDK.

‫v4.4.3 (‫20 مارس 2023)

تغيير في التبعية

• يجب ترقية تبعية حزمة تطوير البرامج للتنقّل إلى الإصدار 4.4.1.

‫v4.4.2 (‫15 فبراير 2023)

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

• تحسين وقت استعادة الاتصال بالشبكة عندما تواجه حزمة SDK مشكلة مؤقتة في الاتصال هذا إصلاح تجريبي.

• تجاهُل طلبات UpdateVehicle التي تحتوي فقط على موقع جغرافي "أولي"

• إصلاح مشكلة التزامن في واجهة برمجة التطبيقات ALPHA الخاصة بـ "نظرة عامة على المسار"

‫4.4.1 (18 نوفمبر 2022)

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

• تم إصلاح خطأ في منطق تحميل الزيارات.

تغييرات إضافية

• تحسينات داخلية في عناوين الطلبات وإعداد التقارير عن رموز الحالة

‫4.4.0 (21 سبتمبر 2022)

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

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

تغيير في التبعية

• يجب ترقية تبعية حزمة Navigation SDK إلى الإصدار 4.2.2.

‫4.3.0 (24 أغسطس 2022)

تحسينات داخلية

إشعار: إيقاف التوافق مع الإصدار 5 من نظام التشغيل Android (21 تموز/يوليو 2022)

بالنسبة إلى أحدث إصدار من حزمة SDK (الإصدار 4.2.0)، سنوفّر سنة إضافية من الدعم للتطبيقات التي تعمل على نظام التشغيل Android 5، وذلك لكل من المستوى 21 والمستوى 22 من واجهة برمجة التطبيقات.

ويعني ذلك أنه:

• ستتوافق حزمة تطوير البرامج للتنقّل وحزمة تطوير البرامج للسائق التي تعمل على تطبيقات Android مع الإصدار 5 من نظام التشغيل Android (المستوى 21 من واجهة برمجة التطبيقات) كحد أدنى حتى 30 يونيو 2023.
• بعد 30 يونيو 2023، لن نتوافق إلا مع المستوى 23 من واجهة برمجة التطبيقات Android والإصدارات الأحدث. بعبارة أخرى، سنتوقف عن توفير الدعم للمستويَين 21 و22 من واجهة برمجة تطبيقات Android في جميع إصدارات حزمة تطوير البرامج (SDK) بعد هذا التاريخ. وهذا يعني أنّه لن يتم إصلاح الأخطاء المرتبطة بالإصدار 21 أو 22 من نظام التشغيل Android في أي إصدار من حزمة SDK (بما في ذلك الإصدار 4.x)، ولا نضمن أن تعمل حِزم SDK بشكل صحيح.

يحلّ هذا الإشعار محلّ إشعار إيقاف الدعم للإصدارَين 21 و22 من نظام التشغيل Android الصادر في 21 يونيو 2021، وإشعار إيقاف الدعم للإصدارات 23 و24 و25 من نظام التشغيل Android الصادر في 18 أكتوبر 2021.

‫4.2.0 (8 يونيو 2022)

تغيير في التبعية

• يجب ترقية إصدار حزمة تطوير البرامج (SDK) لخدمة "خرائط Google" إلى الإصدار 4.1.3.
• يتم خفض الحد الأدنى لمستوى واجهة برمجة تطبيقات Android المتوافق إلى المستوى 21.

‫4.1.0 (28 أبريل 2022)

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

• تمت إعادة تسمية السمة parentId للعنصر Task إلى trackingId. لا يزال العنصر القديم متوفّرًا في الوقت الحالي، ولكن تم إيقافه نهائيًا.

‫4.0.0 (‫29 نوفمبر 2021)

الحد الأدنى لمستوى واجهة برمجة تطبيقات Android المتوافق مع هذا الإصدار هو 23.

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

في هذا الإصدار، تم تعديل حزمة Driver SDK لنظام التشغيل Android من خلال إجراء التغييرات التالية.

تغيير في VehicleStops API

تشير عناصر VehicleStop الآن إلى قائمة بعناصر TaskInfo بدلاً من قائمة بعناصر Task. إذا كنت بحاجة إلى حالة المهمة، ننصحك بتتبُّعها في الرمز البرمجي لتطبيقك.

• تمت إضافة فئة جديدة: TaskInfo

• تم استبدال الدالة getTasks الخاصة بـ VehicleStop بالدالة getTaskInfoList.

• تم استبدال الدالة setTasks الخاصة بـ VehicleStop.Builder بالدالة setTaskInfoList.

رصد الأعطال

تمّت إضافة ميزة مراقبة الأعطال وإعداد التقارير عنها للمساعدة في تحسين استقرار حزمة تطوير البرامج (SDK). تكون هذه الميزة مفعّلة تلقائيًا، ولكن يمكنك إيقافها إذا استدعيت setAbnormalTerminationReportingEnabled() وأدخلت القيمة false قبل تهيئة حزمة تطوير البرامج (SDK).

• تمت إضافة الدالة setAbnormalTerminationReportingEnabled إلى DriverApi.

Async getRemainingVehicleStops

• تم تغيير وظيفة DeliveryVehicleReporter getRemainingVehicleStops لتعرض Future<List<VehicleStop>> بدلاً من List<VehicleStop>.

المصادقة

تمت إزالة الخصائص غير الضرورية من واجهة AuthTokenContext. تم إيقاف ServiceType نهائيًا. ما عليك سوى الحصول على المطالبات الخاصة بمعرّف المركبة ومعرّف المهمة المضمّنين، بدلاً من الاعتماد على ServiceType.

• تمت إزالة "ServiceType" من AuthTokenContext.

• تمت إزالة "getServiceType()" من AuthTokenContext.

• تمت إزالة "setServiceType" من AuthTokenContext.Builder.

‫18 أكتوبر 2021 - إيقاف دعم المستوى 23 و24 و25 من واجهة برمجة التطبيقات

تنبيه: تم إلغاء هذا الإشعار. يُرجى الاطّلاع على إشعار معدَّل بتاريخ 21 يوليو 2022.

الاطّلاع على الإشعار الصادر في 18 تشرين الأول (أكتوبر)

استجابةً للتغييرات في التبعيات الداخلية، لن تتوافق المستويات 23 و24 و25 من واجهة برمجة التطبيقات Android (الإصدارات 6 و7.0 و7.1 من Android) مع الإصدارات الجديدة من حزمتَي Navigation SDK وDriver SDK لنظام التشغيل Android، وذلك اعتبارًا من الربع الثالث من عام 2022.

إنّ حِزم تطوير البرامج (SDK) الخاصة بخدمتَي Navigation وDriver لنظام التشغيل Android، والتي تم إصدارها بدءًا من الربع الثالث من عام 2022، ستتوافق فقط مع الأجهزة التي تعمل بالإصدار 26 أو الإصدارات الأحدث من واجهة برمجة التطبيقات لنظام التشغيل Android.

ستستمر إصدارات التطبيقات التي تم إنشاؤها باستخدام الإصدار 4.x أو إصدار أقدم من حزمتَي تطوير البرامج Navigation SDK وDriver SDK لنظام التشغيل Android في العمل على الأجهزة التي تعمل بالمستوى 25 من واجهة برمجة التطبيقات Android API أو إصدار أقدم.

الإصدار 3.0.4 (‫28 يوليو 2021)

الميزات

في هذا الإصدار، تم فصل حزمة Driver SDK رسميًا عن حزمة Navigation SDK. راجِع دليل نقل البيانات للاطّلاع على التفاصيل.

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

تمت إضافة الطرق التالية:

‫`RidesharingDriverApi.getDriverSdkVersion()`

إصلاح الأخطاء وتحسينات على ثبات الأداء

الإبلاغ عن أخطاء PERMISSION_DENIED بدلاً من تصنيفها على أنّها أخطاء في الاتصال

إشعار بشأن الإيقاف النهائي (21 يونيو 2021)

يوضّح هذا الإشعار عمليات الإيقاف النهائي لحزمة تطوير البرامج Driver SDK لنظام التشغيل Android وحزمة تطوير البرامج Navigation SDK لنظام التشغيل Android اعتبارًا من التاريخ المذكور أعلاه. تم إرسال هذا الإشعار أيضًا كإشعار إلزامي عن الخدمة (MSA) إلى العملاء المتأثرين.

ستصبح حزمة تطوير البرامج للتنقّل/السائق على أجهزة Android هي الإصدار 3.x من حزمة تطوير البرامج للتنقّل على أجهزة Android والإصدار 3.x من حزمة تطوير البرامج للسائق على أجهزة Android (ملفات ثنائية مقسّمة)

لتبسيط عملية دمج العملاء وتسريع قدرتنا على تقديم ميزات مفيدة، سنقسّم حزمة تطوير البرامج للتنقّل على أجهزة Android وحزمة تطوير البرامج للسائقين على أجهزة Android إلى ملفَين ثنائيَين مختلفَين:

• ‫Navigation SDK for Android، التي ستوفّر وظائف التنقّل/تحديد المسار للسائقين
• حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بالسائقين، والتي ستتيح لك الاستفادة من خدمات الويب ذات الحالة في Fleet Engine لتتبُّع تقدّم الرحلات أو المهام وتحديدها

يُرجى العِلم أنّ حزمة تطوير البرامج Driver SDK لنظام التشغيل Android تتطلّب توفّر حزمة تطوير البرامج Navigation SDK لنظام التشغيل Android من أجل تنفيذ وظائف التوجيه الأساسية.

ما هي التغييرات؟

في ما يلي التغييرات الرئيسية في الإصدار 3:

• ملفان ثنائيان بدلاً من ملف واحد
• تعريفات أوضح للحِزم في فئات Driver SDK لنظام التشغيل Android
• تتضمّن حزمة تطوير البرامج للتنقّل على أجهزة Android حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android كجزء من الحزمة (اعتبارًا من الإصدار 2 من حزمة تطوير البرامج للتنقّل على أجهزة Android).
  • يتيح ذلك إمكانية عرض الخرائط وميزات التنقّل معًا على الخريطة نفسها (مثل رسم خطوط متعددة الأضلاع على NavigationView)، ويقلّل من استخدام الذاكرة لأنّه يتم استخدام خريطة واحدة بدلاً من اثنتين.
  • لا يتوافق الإصدار 3.0 من حزمة تطوير البرامج للتنقّل على أجهزة Android مع جميع ميزات حزمة تطوير البرامج للتنقّل على أجهزة Android، ولكن سيتم حلّ معظم المشاكل في الإصدار 3.2. لمزيد من التفاصيل، يُرجى الاطّلاع على الإجراءات التي يمكن اتخاذها ومتى.
• تسجيل البيانات الذي سيسهّل علينا تصحيح الأخطاء التي قد تواجهها

تمت أيضًا إزالة الطرق التالية في الإصدار 3، بعد أن تم وضع علامة عليها سابقًا باعتبارها متوقفة، ويتوفّر لها حل بديل:

• تم إيقاف طرق Nav/Driver SDK التالية نهائيًا في الإصدار 1.16 الذي تم إصداره في 10 أغسطس 2020، وتمت إزالتها في الإصدار 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• للتوضيح، يُرجى العلم أنّه تمت إزالة عدد من الطرق عند الانتقال من الإصدار 1 إلى الإصدار 2. معظم هذه التغييرات كانت عبارة عن دمج لفئات مكرّرة بين حزمة تطوير البرامج للتنقّل على أجهزة Android و&quot;حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android&quot; لأجهزة Android. يُرجى الاطّلاع على دليل نقل البيانات لفهم هذه التغييرات بشكل أفضل.

الإيقاف النهائي للإصدار 1.x من حزمة تطوير البرامج للتنقّل على أجهزة Android وحزمة Driver SDK لنظام التشغيل Android

تم طرح الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بخدمة &quot;الملاحة&quot; و&quot;السائق&quot; في عام 2018، ومع اقتراب طرح الإصدار 3، حان الوقت لإيقاف الإصدار 1 نهائيًا لتجنُّب عدم القدرة على مواصلة توفير الدعم للعديد من الإصدارات الرئيسية.

سيسمح لنا الوقت الذي نوفّره من خلال عدم الحاجة إلى توفير هذا الإصدار الإضافي بتقديم دعم أفضل لأحدث رقم إصدار رئيسي وإنشاء المزيد من الميزات المهمة لعملائنا.

وبالتالي، تم إيقاف الإصدار 1.x من حزمة تطوير البرامج (SDK) الخاصة بخدمة &quot;الملاحة&quot; و&quot;السائق&quot; نهائيًا، ولن يتم توفير أي تحديثات له بعد 21 يونيو 2022.

يُرجى الاطّلاع على طريقة عمل عمليات الإيقاف النهائي في إصدارات حزمة تطوير البرامج (SDK).

إيقاف الدعم نهائيًا لإصدارَي Android 21 و22 من حزمة تطوير البرامج للتنقّل وحزمة تطوير البرامج للسائقين

تنبيه: تم إلغاء هذا الإشعار. يُرجى الاطّلاع على إشعار معدَّل بتاريخ 21 يوليو 2022.

قراءة الإشعار بشأن الإلغاء

سيتوافق الإصدار 4.0 القادم من حزمة تطوير البرامج للتنقّل على أجهزة Android وDriver SDK لنظام التشغيل Android مع الحد الأدنى من [Android 6.0 (المستوى 23 من واجهة برمجة التطبيقات)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. الحد الأدنى للإصدار المتوافق حاليًا هو Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات). نتوقّع طرح الإصدار 4.0 في الربع الرابع من عام 2021. ويعني ذلك ما يلي:

• ستستمر إصدارات التطبيقات التي تم إنشاؤها باستخدام إصدارات أقدم من الإصدار 4.x في العمل على أجهزة Android 21 و22. ستستمر تطبيقات السائقين التي تتضمّن حِزم SDK الحالية في العمل على الأجهزة التي تعمل بالإصدار 21 من نظام التشغيل Android أو الإصدارات الأحدث، كما كان الحال في السابق.
• لن يتمكّن المستخدمون من تثبيت إصدارات التطبيق التي تم إنشاؤها باستخدام حزمة Driver SDK لنظام التشغيل Android وNavigation SDK لنظام التشغيل Android الإصدار 4.x (المستهدف في الربع الرابع من عام 2021، وقد يتغيّر ذلك) والإصدارات الأحدث على الأجهزة التي تعمل بنظام التشغيل Android 21 و22. سيعمل الإصدار 4.x على الحد الأدنى من نظام التشغيل Android 6.0 (مستوى واجهة برمجة التطبيقات 23)، لذا لن يتمكّن السائقون من تلقّي إصدارات تطبيقك التي تم إنشاؤها باستخدام الإصدار 4.x القادم إلا إذا كانت أجهزتهم تعمل بنظام التشغيل Android 23 أو إصدار أحدث. يعني ذلك أنّ التغييرات المرتبطة بحزمة SDK وأي تغييرات أجريتها على التطبيق لن تصل إلى السائقين الذين يستخدمون أجهزة تعمل بنظام التشغيل Android 21 و22.

يوضّح الجدول التالي إصدارات حزمة تطوير البرامج للتنقّل على أجهزة Android الإصدار 3 وDriver SDK for Android الإصدار 3 التي عليك الترقية إليها، بالإضافة إلى موعد توفّرها.

ما هي ميزات منصة "السائق" التي تستخدمها؟	هل تستخدم هذه الإمكانات؟	بعد ذلك، ستكون الإصدارات الأولى المتاحة التي يجب الترقية إليها هي...	تاريخ الإتاحة المتوقّع (قد يختلف)	روابط نقل البيانات
التنقّل فقط (طُرق NavSDK)	لا	NavSDK الإصدار 3.0.1	الآن	الدليل
	نعم	‫NavSDK الإصدار 3.5 (المتوقّع)	أيلول (سبتمبر) 2021
التنقّل والتتبُّع في Fleet Engine (طُرق NavSDK وDriverSDK)	لا	الإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation والإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة بخدمة Driver		سيتوفّر دليل نقل البيانات إلى الإصدار 3.0 من برنامج التشغيل عند الإصدار
	نعم	الإصدار 3.x من NavSDK والإصدار 3.0 من DriverSDK

لمواصلة استخدام الطرق التي تمت إزالتها، يمكنك البقاء على الإصدار 1.x، ولكن بدون توقّع الحصول على الدعم أو الصيانة بعد 21 يونيو 2022 (راجِع القسم التالي).

ننصحك بنقل البيانات إلى الإصدار 3.x. ويعني ذلك ما يلي:

* سيتم طرح آخر إصدار من السلسلة 1.x في الربع الرابع من عام 2021 (وبالتالي، سيتم إيقاف إضافة ميزات جديدة إلى الإصدار 1 من ذلك الحين).

* يمكن إصلاح هذا الإصدار الأخير لمدة 6 أشهر بعد ذلك، أي حتى 21 يونيو 2022. بعد هذا التاريخ، لن نتمكّن من الرد على طلبات إصلاح الأخطاء أو طلبات الميزات الخاصة بالإصدار 1.x.

يُرجى تخصيص بعض الوقت لمراجعة الجدول التالي و[دليل النقل](/maps/documentation/navigation-sdk-android/v2/migration) لمساعدتك في التعامل مع هذه التغييرات.

ما هي الإجراءات التي يمكنني اتّخاذها ومتى؟

إذا كنت تستخدم حاليًا...	هل تستخدم هذه الإمكانات؟	الترقية الآن	لإجراء الترقية في سبتمبر 2021	روابط نقل البيانات
‫v1.x (لا تستخدم FleetEngine.java / وظائف السائق)	لا	الإصدار 3.0 من NavSDK		الدليل
	نعم	لا يتوفّر خيار	NavSDK 3.x
الإصدار 1.x (باستخدام FleetEngine.java / وظائف السائق)	لا	لا يتوفّر خيار	‫NavSDK 3.x + DriverSDK 3.x	الدليل أعلاه، بالإضافة إلى دليل نقل البيانات إلى الإصدار 3.0 من Driver الذي سيتوفّر عند الإصدار
	نعم

ننصحك بإرسال إشعار إلى السائقين الذين يستخدمون أجهزة تعمل بالإصدارين 21 و22 من نظام التشغيل Android لترقية نظام التشغيل إلى إصدار أحدث (الإصدار 6.0 من نظام التشغيل Android كحد أدنى) قبل دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بالسائقين والإصدار 4.x والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بخدمة Navigation في تطبيق السائق.

الإصدار 1.15.3 (9 أكتوبر 2020)

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

• تتضمّن حزمة Driver SDK الآن اشتراكًا في حزمة Navigation SDK لتلقّي آخر المعلومات عن حركة المرور، ويتم إرسال هذه المعلومات إلى Fleet Engine API.

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تم إصلاح عُطل في وقت تشغيل gRPC.

v1.15.2

الميزات

تمت إضافة إمكانية إيقاف الإشعارات الدائمة. في حال إيقاف ميزة "الإبلاغ عن الموقع الجغرافي" في مثيل Fleet Engine، يتم إيقاف التوجيه في Navigator، ويتم إلغاء تسجيل جميع أدوات معالجة أحداث التنقّل، ويتم إيقاف NavigationFragment أو NavigationView مؤقتًا.

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تم إصلاح الخطأ الذي كان يتسبب في ظهور استثناء إذا تمت إزالة مثيل Fleet Engine.

الإصدار 1.15.1 (12 مايو 2020)

الميزات

أشارت التحليلات الأولية لبيانات الإصدار 1.15.0 إلى تحسينات كبيرة في إعداد التقارير عن المواقع الجغرافية الثابتة (تقليل المواقع الجغرافية "العالقة"). يسمح إصلاح هذا الخطأ بمواصلة عملية إعداد التقارير المحسّنة عن الموقع الجغرافي. لم تكن مشكلة ANR مرتبطة بهذه التحسينات.

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تم إصلاح الخلل الذي كان يؤدي أحيانًا إلى ظهور خط مستقيم في بداية المسار في تطبيق المستهلك.
• تم إصلاح خطأ كان يمكن أن يؤدي إلى حدوث خطأ ANR عند إرسال بيانات المواقع الجغرافية من خلال حزمة SDK. وقد نتج ذلك عن onArrival() تحسينات كانت عرضة لتنازع القفل. تمكّنا من إعادة إنتاج أخطاء ANR بشكل موثوق في بعض الحالات، وتمكّنا من التأكّد من أنّ الإصلاحات قد حلّت المشكلة. استمر تشغيل تطبيق الاختبار المعدَّل الذي ينتج أخطاء ANR لمدة ثماني ساعات بدون حدوث خطأ ANR بعد إصلاحه.

الإصدار 1.15.0 (‫23 مارس 2019)

الميزات

• تم تقديم حالة إرشادات التنقّل عند أحداث البدء والخروج عن المسار والوصول لتحسين تتبُّع الموقع الجغرافي للمركبة.
• تمت إضافة إمكانية مواصلة الحصول على مواقع جغرافية محاذية للطرق بغض النظر عن حالة التنقّل.
• تمت إضافة معلومات إضافية حول المواقع الجغرافية التي تم تعديلها مسبقًا لتتطابق مع الطرق، مثل الدقة.

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تمت زيادة minSdkVersion لـ navsdk إلى 19.
• تم إصلاح خطأ كان يتسبب في عدم قبول أسماء نقاط الطريق التي تتضمّن خطوط الطول والعرض عند تعذُّر الترميز الجغرافي العكسي من جهة الخادم.

الإصدار 1.14.2 (2 فبراير 2019)

الميزات

• يمنع DriverSDK إرسال المواقع الجغرافية 0,0 إلى Fleet Engine (مشاركة أفضل للرحلة وإدخالات الموقع الجغرافي للتخصيص).
• تسجيل بيانات إضافية لتحسين المشاكل المتعلّقة بتعذّر تحديد الموقع الجغرافي وتقليل عمليات الرجوع إلى الإصدارات السابقة من ميزة &quot;مشاركة الرحلة&quot;
• تجاهُل الطلبات المتكرّرة إلى setLocationReportingInterval() ما لم يتغير الفاصل الزمني
• تم تعديل مستندات Javadoc الخاصة بالطريقة setReportingInterval() بهدف تثبيط الاستدعاء المتكرّر لهذه الطريقة بمعدّل مرتفع مقارنةً بالفواصل الزمنية المستخدَمة.
• تم تحسين موثوقية الموقع الجغرافي في الإصدار 29 من واجهة برمجة التطبيقات.

v1.13.0

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تضيف هذه السمة اعتمادًا على okhttp يجب أن يضيفه العملاء إلى إصدارات gradle.

الإصدار 1.11.7 (‫18 أكتوبر 2019)

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تستمر الآن تحديثات الموقع الجغرافي بعد إطلاق onArrival() لوجهة معيّنة.
• يتطابق الإشعار التلقائي (سلسلة ثابتة في "وضع التنقّل الحر") مع نظام الألوان الذي تم ضبطه لإشعارات التنقّل. لمزيد من المعلومات، يُرجى الاطّلاع على الإشعارات الثابتة المشترَكة.
• تم حلّ مشكلة كان فيها حدث إشعار بشأن الموقع الجغرافي المتأخّر يتسبّب في إشعار بشأن الموقع الجغرافي بشكل غير صحيح، ما يؤدي إلى ظهور عناصر غير صحيحة، مثل خط مستقيم في بداية مسار.

الإصدار 1.11.6 (‫04 أكتوبر 2019)

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

• أجرينا سلسلة من التغييرات التي تضمن استئناف Driver SDK لعمليات تعديل الموقع الجغرافي بسرعة بعد حدوث عطل في الشبكة. بعد استعادة الاتصال بالشبكة، ستبدأ الإشعارات بشأن الموقع الجغرافي بالوصول مرة أخرى عند إرسال الإشعار التالي المجدوَل بشأن الموقع الجغرافي.

إصلاح الأخطاء وتحسينات على ثبات الأداء

• تعرض الدالة setVehicleState() الآن النتيجة على الفور. يتم الآن تعديل FleetEngine في سلسلة محادثات في الخلفية. تعمل هذه التحديثات على حلّ مشكلة "التطبيق لا يستجيب" (ANR).
• تم إصلاح مشكلة كانت تتسبّب في عرض مسارات مشاركة الرحلة كخط مستقيم باستخدام الإصدارات القديمة من Consumer SDK. يضمن عدم إضافة نقاط توقّف مؤقتة إلى المسار من خلال حزمة تطوير البرامج (SDK) الخاصة بالسائق.