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

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

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

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

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

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

  • تم تعديل إصدارات Navigation SDK المتوافقة لتشمل الإصدارات التي تبدأ من الإصدار 7.0.0.

‫6.99.0 (‫5 ديسمبر 2025)

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

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

وفقًا لسياسة توافق إصدارات نظام التشغيل على الأجهزة الجوّالة، سنتوقف عن إتاحة الإصدارَين 6 و7 من نظام التشغيل Android (المستوى 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.

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

‫6.1.0 (10 مارس 2025)

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

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

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

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

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

‫v6.0.0 (‫25 نوفمبر 2024)

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

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

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

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

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

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

‫5.99.0 (‫20 سبتمبر 2024)

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

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

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

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

‫5.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.
  • يجب تفعيل عملية إزالة السكر من التطبيقات التي تستخدم Driver 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).
  • منع انخفاض الوقت المقدَّر للوصول تلقائيًا عندما تكون المركبة متوقفة سيتم طرح هذا التغيير تدريجيًا كتجربة، لذا لن يظهر هذا التغيير في جميع التطبيقات في الوقت نفسه.

‫v4.5.0 (12 مايو 2023)

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

‫4.4.3 (‫20 مارس 2023)

تغيير الاعتمادية

  • يجب ترقية عنصر Navigation SDK الاعتمادي إلى الإصدار 4.4.1.

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

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

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

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

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

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

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

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

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

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

‫v4.4.0 (‫21 سبتمبر 2022)

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

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

تغيير الاعتمادية

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

‫4.3.0 (24 أغسطس 2022)

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

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

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

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

  • ستتوافق حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation API وحزمة تطوير البرامج (SDK) الخاصة بخدمة Driver API اللتان تعملان على تطبيقات 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)

تغيير الاعتمادية

  • يجب ترقية عنصر Nav SDK الاعتمادي إلى الإصدار 4.1.3.
  • يتم خفض الحد الأدنى لمستوى واجهة برمجة تطبيقات Android المتوافق إلى 21.

‫v4.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 قبل تهيئة حزمة تطوير البرامج.

Async getRemainingVehicleStops

المصادقة

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

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

قراءة الإشعار الصادر في 18 تشرين الأول (أكتوبر)

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

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

ستستمر إصدارات التطبيقات التي تم إنشاؤها باستخدام الإصدار 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 وحزمة تطوير البرامج Driver SDK لنظام التشغيل Android إلى ملفَين ثنائيَين مختلفَين:

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

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

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

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

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

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

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

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

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

يُرجى تخصيص بعض الوقت لمعرفة طريقة عمل الإيقاف النهائي في إصدارات حزمة SDK الأقدم من 10.

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

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

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

ما هي ميزات "منصة السائق" التي تستخدمها؟ هل تستخدم هذه الإمكانات؟ إليك الإصدارات الأولى المتاحة التي يجب الترقية إليها: تاريخ الإتاحة المتوقّع
(قد يختلف)		 روابط نقل البيانات
التنقّل فقط
(طُرق NavSDK)		 لا NavSDK v3.0.1 الآن الدليل
نعم ‫NavSDK الإصدار 3.5 (قيمة متوقّعة) أيلول (سبتمبر) 2021
التنقّل والتتبُّع في Fleet Engine (طُرق NavSDK وDriverSDK) لا الإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation والإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة ببرنامج التشغيل سيتوفّر دليل نقل البيانات إلى الإصدار 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 / وظائف السائق) 		لا NavSDK الإصدار 3.0 الدليل
نعم لا يتوفّر خيار NavSDK 3.x
v1.x
(باستخدام FleetEngine.java / وظائف السائق)		 لا لا يتوفّر خيار ‫NavSDK 3.x +
DriverSDK 3.x		 الدليل أعلاه، بالإضافة إلى دليل نقل البيانات إلى الإصدار 3.0 من Driver المتاح عند الإصدار
نعم

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

الإصدار 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() ما لم يتغيّر الفاصل الزمني
  • تم تعديل مستندات Javadoc الخاصة بالطريقة setReportingInterval() بهدف تثبيط الاستدعاء المتكرّر لهذه الطريقة بمعدّل مرتفع مقارنةً بالفواصل الزمنية المستخدَمة.
  • تم تحسين موثوقية الموقع الجغرافي في الإصدار 29 من واجهة برمجة التطبيقات.

v1.13.0

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

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

الإصدار 1.11.7 (18 تشرين الأول/أكتوبر 2019)

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

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

الإصدار 1.11.6 (4 تشرين الأول/أكتوبر 2019)

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

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

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

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