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

يحتوي هذا القسم على ملاحظات إصدار حزمة تطوير البرامج (SDK) للسائق على Android.

الإصدار 7.99.0 (‫11 نوفمبر 2026)

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

  • تم إصلاح مشكلة كانت تؤدي إلى بقاء محاولات الاتصال الآمن بـ Fleet Engine معلّقة إلى أجل غير مسمى في حال توقُّف خادم وكيل وسيط لمشغّل شبكة الجوّال أثناء إعداد الاتصال، ما يمنع إعادة تحميل حالة الرحلة وتحديثات تتبُّع المركبات على شبكات جوّال معيّنة. تفرض حزمة تطوير البرامج (SDK) الخاصة بالسائق الآن مهلة للاتصال وتستعيد الاتصال تلقائيًا عند إنشاء اتصال جديد.

  • تم إصلاح تسرُّبات سلاسل المحادثات والمنفّذين عند استدعاء DriverApi.clearInstance() (منفّذو FleetEngineEventHandler وFusedLocationWriter وDriverApi).

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

  • تمت ترقية تبعيات Jetpack DataStore (androidx.datastore:datastore-core وandroidx.datastore:datastore-guava) إلى الإصدار 1.2.1.

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

  • تم تعديل نطاق إصدارات حزمة تطوير البرامج (SDK) للتنقّل المتوافقة إلى [7.9.0, 8.0.0).

الإصدار 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.

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

الإصدار 7.0.0 (‫5 ديسمبر 2025)

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

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

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

  • تم تعديل الإصدارات المتوافقة مع حزمة Navigation SDK، بما في ذلك الإصدار 7.0.0 والإصدارات الأحدث.

الإصدار 6.99.0 (‫5 ديسمبر 2025)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الإصدار 5.99.1 (‫10 يناير 2025)

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

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

الإصدار 6.0.0 (‫25 نوفمبر 2024)

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

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

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

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

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

  • إزالة التبعية لـ glide:cronet-integration في ملف POM.xml
  • تم تعديل الإصدارات المتوافقة من حزمة تطوير البرامج (SDK) للتنقّل إلى الإصدار 5.x.
  • بدءًا من الإصدار 6.0.0 من حزمة تطوير البرامج (SDK) الخاصة بالسائق لنظام التشغيل Android، يجب ترقية التطبيقات إلى الإصدار 2.0 من Kotlin.
  • أصبح الإصدار المستهدَف من حزمة تطوير البرامج (SDK) هو المستوى 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)

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

  • تم تحديث حزمة تطوير البرامج (SDK) للتنقّل إلى الإصدار 5.x.
  • تمت ترقية minSdkVersion إلى المستوى 23 من واجهة برمجة التطبيقات.
  • تمت ترقية إصدار Kotlin إلى 1.9.0.
  • تمت إضافة التبعية على Room. * يجب أن تستخدم التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) للسائقين الآن targetSdkVersion من المستوى 31 أو أعلى لواجهة برمجة التطبيقات.
  • يجب الآن تفعيل دعم مكتبة Java 8 في التطبيقات التي تستخدم حزمة تطوير البرامج (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)

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

الإصدار 4.4.3 (‫20 مارس 2023)

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

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

الإصدار 4.4.2 (‫15 فبراير 2023)

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

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

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

  • تم إصلاح مشكلة التزامن في واجهة برمجة التطبيقات "نظرة عامة على المسار" (Route Overview) في الإصدار الأولي.

الإصدار 4.4.1 (‫18 نوفمبر 2022)

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

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

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

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

الإصدار 4.4.0 (‫21 سبتمبر 2022)

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

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

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

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

الإصدار 4.3.0 (24 أغسطس 2022)

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

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

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

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

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

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

الإصدار 4.2.0 (8 يونيو 2022)

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

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

الإصدار 4.1.0 (‫28 أبريل 2022)

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

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

الإصدار 4.0.0 (29 نوفمبر 2021)

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

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

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

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

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

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

الميزات

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

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

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

‫`RidesharingDriverApi.getDriverSdkVersion()`‎

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

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

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

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

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

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

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

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

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

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

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

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

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

تم طرح الإصدار Nav/Driver SDK v1 في عام 2018، ومع اقتراب طرح الإصدارات v3، حان الوقت لإيقاف الإصدار v1 نهائيًا لتجنُّب عدم استدامة دعم العديد من أرقام الإصدارات الرئيسية.

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

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

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

قراءة الإشعار الذي تم إبطاله

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

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

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

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

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

* سيتم طرح آخر إصدار من v1.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 / وظائف السائق)
لا لا يتوفّر خيار الإصدار 3.x من NavSDK‏ +
الإصدار 3.x من DriverSDK
الدليل أعلاه، بالإضافة إلى دليل نقل البيانات إلى الإصدار 3.0 من Driver الذي سيكون متاحًا عند الإصدار
نعم

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

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

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

  • تشترك حزمة تطوير البرامج (SDK) الخاصة بالسائق الآن في حزمة تطوير البرامج (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 (4 أكتوبر 2019)

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

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

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

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