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

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

‫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

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

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

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

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

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

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

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

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

  • بدءًا من الإصدار 6.2.0 من حزمة تطوير البرامج (SDK) للسائقين على Android، يجب ترقية التطبيقات إلى الإصدار 2.1 من Kotlin.

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

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

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

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

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

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

  • تم إصلاح المشكلة التي كانت تتسبّب في تلقّي برامج التشغيل أخطاء gRPC بالرمز "INTERNAL" والرسالة "Panic! This is a bug!" description on application first launch after install.

‫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.
  • أصبح الإصدار المستهدَف من حزمة تطوير البرامج (SDK) هو المستوى 34 لواجهة برمجة التطبيقات. وهذا شرط يجب استيفاؤه في جميع التطبيقات التي سيتم نشرها على "متجر Google Play" اعتبارًا من أغسطس 2024. يُرجى الاطّلاع على مقالة استيفاء متطلبات مستوى واجهة برمجة التطبيقات المستهدَف في Google Play.

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

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

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

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

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

الإصدار 5.0.0 (‫12 سبتمبر 2023)

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

  • تم تحديث حزمة تطوير البرامج (SDK) للتنقّل إلى الإصدار 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).

الإصدار 4.99.0 (9 أغسطس 2023)

  • إتاحة مجموعة من الإصدارات لتبعية NavSDK ** يتوافق مع الإصدار 4.5.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).

Async getRemainingVehicleStops

المصادقة

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

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

الاطّلاع على الإشعار الصادر في 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)

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

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

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

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

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

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

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

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

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

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

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

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

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

سيتوافق الإصدار 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)		 لا الإصدار 3.0.1 من NavSDK الآن الدليل
نعم الإصدار 3.5 من NavSDK (المتوقّع) أيلول (سبتمبر) 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 روابط نقل البيانات
الإصدار 1.x
(لا يستخدم FleetEngine.java أو وظائف السائق) 		لا الإصدار 3.0 من NavSDK الدليل
نعم لا يتوفّر خيار NavSDK 3.x
الإصدار 1.x
(باستخدام FleetEngine.java / وظائف السائق)		 لا لا يتوفّر خيار ‫NavSDK 3.x +
DriverSDK 3.x		 الدليل أعلاه، بالإضافة إلى دليل نقل بيانات Driver v3.0 المتاح عند الإصدار
نعم

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

الإصدار 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 (إدخالات أفضل لمشاركة الرحلات وتحديد المواقع الجغرافية).
  • تمت إضافة ميزة تسجيل البيانات لتحسين مشاكل الموقع الجغرافي المتوقّف وتقليل عمليات الرجوع إلى الإصدارات السابقة لمشاركة الرحلة.
  • تجاهُل الطلبات المتكرّرة إلى setLocationReportingInterval() ما لم يتغير الفاصل الزمني
  • تم تعديل javadocs لطريقة 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) الخاصة بالسائق.