يحتوي هذا القسم على ملاحظات حول إصدار Driver SDK لنظام التشغيل Android.
إشعار: إيقاف دعم المستوى 23 و24 و25 من واجهة برمجة التطبيقات
وفقًا لسياسة توافق إصدارات نظام التشغيل على الأجهزة الجوّالة، سنتوقف عن توفير الدعم لنظامَي التشغيل Android 6 و7 (المستوى 23 و24 و25 من واجهة برمجة التطبيقات) في الإصدارات الرئيسية القادمة من Driver SDK لنظام التشغيل Android.
ستتيح إصدارات Driver SDK لنظام التشغيل Android التي سيتم طرحها بدءًا من الربع الرابع من عام 2025 الحد الأدنى من الإصدار Android 8 (المستوى 26 من واجهة برمجة التطبيقات). ستواصل إصدارات حزمة SDK السابقة توفير الدعم لنظامَي التشغيل Android 6 و7.
إذا لم تحدّد التبعيات رقم إصدار، سيحمّل بيئة التطوير المتكاملة أحدث إصدار من حزمة SDK، ولن تتوافق الإصدارات الجديدة من تطبيقك مع الإصدارَين 6 و7 من نظام التشغيل Android.
حدِّد إصدارًا من Driver SDK لنظام التشغيل Android في تبعيات الإصدار لتطبيقك من أجل التحكّم في وقت رفع الحد الأدنى لنظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.
6.2.0 (18 يونيو 2025)
إصلاح الأخطاء
- تم إصلاح عُطل
NullPointerException
أثناء الاتصال بالرقمDriverApi.createInstance()
عند عدم توفيرDriverStatusListener
.
التغييرات في التبعيات والإعدادات
اعتبارًا من الإصدار 6.2.0 من Driver SDK لنظام التشغيل Android، يجب أن يتم ترقية التطبيقات إلى الإصدار 2.1 من Kotlin.
أصبح بإمكانك استخدام إصدارات محدّدة من Navigation SDK، بما في ذلك الإصدار 6.1.0 والإصدارات الأحدث.
v6.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 - تم تعديل حزمة تطوير البرامج للتنقّل لتتوافق مع الإصدارات في النطاق v5.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.
- تمت الترقية إلى الإصدار 23 من واجهة برمجة التطبيقات في
minSdkVersion
. - تمت ترقية إصدار 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.
v4.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)، سنوفّر سنة إضافية من الدعم للتطبيقات التي تعمل على الإصدار 5 من نظام التشغيل Android، وذلك لكل من المستوى 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 بشكل صحيح.
يحلّ هذا الإشعار محلّ إشعار إيقاف توفير الدعم لنظامَي التشغيل Android 21 و22 الصادر في 21 يونيو 2021، وإشعار إيقاف توفير الدعم لأنظمة التشغيل Android 23 و24 و25 الصادر في 18 أكتوبر 2021.
4.2.0 (8 يونيو 2022)
تغيير الاعتمادية
- يجب الترقية إلى الإصدار 4.1.3 من Nav SDK.
- يتم خفض الحد الأدنى لمستوى واجهة برمجة تطبيقات 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
قبل
تهيئة حزمة تطوير البرامج.
- تمت إضافة الدالة
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 من واجهة برمجة التطبيقات
قراءة الإشعار الصادر في 18 تشرين الأول (أكتوبر)
استجابةً للتغييرات في التبعيات الداخلية، لن تتوافق المستويات 23 و24 و25 من واجهة برمجة التطبيقات Android (الإصدارات 6 و7.0 و7.1 من Android) مع الإصدارات الجديدة من حزمتَي تطوير البرامج (SDK) الخاصة بـ "Navigation API" و"Driver API" لنظام التشغيل Android، وذلك بدءًا من الربع الثالث من عام 2022.
لن تتوافق حزمتا تطوير البرامج (SDK) الخاصة بالتنقّل والسائق مع إصدارات Android التي تم طرحها بدءًا من الربع الثالث من عام 2022 إلا مع الأجهزة التي تعمل بالإصدار 26 من واجهة برمجة التطبيقات Android API كحد أدنى.
ستستمر إصدارات التطبيقات التي تم إنشاؤها باستخدام الإصدار 4.x أو الإصدارات الأقدم من حزمتَي تطوير البرامج (SDK) Navigation وDriver لنظام التشغيل Android في العمل على الأجهزة التي تعمل بالمستوى 25 من واجهة برمجة التطبيقات Android أو الإصدارات الأقدم.
الإصدار 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 تتطلّب توفّر حزمة تطوير البرامج للتنقّل على أجهزة 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 وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android. يُرجى الاطّلاع على دليل نقل البيانات لفهم هذه التغييرات بشكل أفضل.
الإيقاف النهائي للإصدار 1.x من حزمة تطوير البرامج للتنقّل على أجهزة Android وحزمة Driver SDK لنظام التشغيل Android
تم طرح الإصدار 1 من حزمة تطوير البرامج (SDK) الخاصة بخدمة "الملاحة" و"السائق" في عام 2018، ومع اقتراب موعد طرح الإصدار 3، حان الوقت لإيقاف الإصدار 1 نهائيًا لتجنُّب عدم القدرة على مواصلة توفير الدعم للعديد من الإصدارات الرئيسية.
سيسمح لنا الوقت الذي نوفّره من خلال عدم الحاجة إلى توفير هذا الإصدار الإضافي بتقديم دعم أفضل لأحدث إصدار رئيسي وإنشاء المزيد من الميزات المهمة لعملائنا.
وبالتالي، تم إيقاف الإصدار 1.x من حزمة تطوير البرامج (SDK) الخاصة بخدمتَي "التنقّل" و"السائق" نهائيًا، ولن يتم صيانتها بعد 21 يونيو 2022.
يُرجى تخصيص بعض الوقت لمعرفة طريقة عمل الإيقاف النهائي في إصدارات حزمة تطوير البرامج (SDK) الأقدم من الإصدار 10.
إيقاف حزمة تطوير البرامج للتنقّل وحزمة تطوير البرامج للسائقين على نظام التشغيل Android 21 وAndroid 22
قراءة الإشعار بشأن الإلغاء
سيتوافق الإصدار 4.0 القادم من حزمة تطوير البرامج للتنقّل على أجهزة Android وDriver 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 والإصدارات الأحدث، كما كان الحال في السابق.
- لن يتمكّن المستخدمون من تثبيت إصدارات التطبيق التي تم إنشاؤها باستخدام حزمة 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 لنظام التشغيل Android الإصدار 3 التي عليك الترقية إليها، بالإضافة إلى موعد توفّرها.
ما هي ميزات منصة "السائق" التي تستخدمها؟ | هل تستخدم هذه الإمكانات؟ | في ما يلي أول الإصدارات المتاحة التي يجب الترقية إليها: | تاريخ الإتاحة المتوقّع (قد يتغيّر) |
روابط نقل البيانات |
---|---|---|---|---|
التنقّل فقط (طُرق NavSDK) |
لا | NavSDK v3.0.1 | الآن | الدليل |
نعم | NavSDK الإصدار 3.5 (قيمة متوقّعة) | أيلول (سبتمبر) 2021 | ||
التنقّل والتتبُّع في Fleet Engine (طُرق NavSDK وDriverSDK) | لا | الإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة بخدمة Navigation والإصدار 3.0 من حزمة تطوير البرامج (SDK) الخاصة ببرنامج التشغيل | سيتوفّر دليل نقل البيانات إلى الإصدار 3.0 من برنامج التشغيل عند الإصدار | |
نعم | NavSDK الإصدار 3.x وDriverSDK الإصدار 3.0 |
لمواصلة استخدام الطرق التي تمت إزالتها، يمكنك البقاء على الإصدار 1.x، ولكن بدون توقّع الحصول على الدعم أو الصيانة بعد 21 يونيو 2022 (راجِع القسم التالي).
ننصحك بنقل البيانات إلى الإصدار 3.x. وهذا يعني ما يلي:
* سيتم إصدار آخر نسخة من الإصدار 1.x في الربع الرابع من عام 2021 (وبالتالي، سيتم إيقاف جميع الميزات في الإصدار 1.x اعتبارًا من ذلك التاريخ).
* يمكن إصلاح هذا الإصدار الأخير لمدة 6 أشهر بعد ذلك، أي حتى 21 يونيو 2022. بعد هذا الوقت، لن نتمكّن من الرد على طلبات إصلاح الأخطاء أو طلبات الميزات للإصدار 1.x.
يُرجى تخصيص بعض الوقت لمراجعة الجدول التالي و[دليل نقل البيانات](/maps/documentation/navigation-sdk-android/v2/migration) لمساعدتك في التعامل مع هذه التغييرات.
ما هي الإجراءات التي يمكنني اتّخاذها ومتى؟
إذا كنت تستخدم حاليًا... | هل تستخدم هذه الإمكانات؟ | الترقية الآن | لإجراء الترقية في سبتمبر 2021 | روابط نقل البيانات |
---|---|---|---|---|
الإصدار 1.x (لا يستخدم FleetEngine.java / وظائف السائق) |
لا | NavSDK الإصدار 3.0 | الدليل | |
نعم | لا يتوفّر خيار | 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 الخاصة بخدمة "التنقّل" في تطبيق السائق.
الإصدار 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)
تحديثات واجهة برمجة التطبيقات
- أجرينا سلسلة من التغييرات التي تضمن استئناف Driver SDK لعمليات تعديل الموقع الجغرافي بسرعة بعد حدوث عطل في الشبكة. بعد استعادة الاتصال بالشبكة، ستبدأ الإشعارات بشأن الموقع الجغرافي بالظهور مجددًا في الموعد التالي المحدّد لتلقّي إشعارات بشأن الموقع الجغرافي.
تحسينات في الثبات وإصلاح الأخطاء
- تعرض الدالة
setVehicleState()
الآن النتيجة على الفور. يتم الآن تعديل FleetEngine في سلسلة محادثات في الخلفية. تعمل هذه الحزمة على حلّ مشكلة "التطبيق لا يستجيب" (ANR). - تم إصلاح مشكلة كانت تتسبّب في عرض مسارات مشاركة الرحلة كخط مستقيم عند استخدام إصدارات قديمة من Consumer SDK. يضمن عدم إضافة نقاط توقّف مؤقتة إلى المسار من خلال Driver SDK.