يتضمّن هذا القسم ملاحظات حول إصدار حزمة Driver SDK لنظام التشغيل Android.
إشعار: إيقاف نهائي لدعم المستوى 23 و24 و25 من واجهة برمجة التطبيقات
وفقًا لسياسة التوافق مع إصدارات نظام التشغيل المتوافقة مع الأجهزة الجوّالة، سنتوقف عن إتاحة التوافق مع الإصدارَين 6 و7 من Android (المستوى 23 و24 و25 من واجهة برمجة التطبيقات) في الإصدارات الكبرى القادمة من حزمة Driver SDK لنظام التشغيل Android.
إصدارات حزمة Driver SDK لنظام التشغيل Android التي تم إصدارها اعتبارًا من الربع الرابع من عام 2025 ستتوافق مع الإصدار 8 من Android (المستوى 26 من واجهة برمجة التطبيقات) كحد أدنى. ستظل إصدارات حزمة SDK الأقدم متوافقة مع Android 6 و7.
إذا لم تحدّد التبعيات رقم إصدار، سيحمِّل بيئة تطوير البرامج IDE أحدث إصدار من حزمة تطوير البرامج ولن تكون الإصدارات الجديدة من تطبيقك متوافقة مع Android 6 و7.
حدِّد إصدارًا من حزمة تطوير برامج (SDK) لبرامج تشغيل Android في تبعيات عملية إنشاء تطبيقك للتحكّم في وقت رفع الحد الأدنى لنظام التشغيل المتوافق مع الإصدارات الجديدة من تطبيقك.
الإصدار 6.0.0 (25 تشرين الثاني (نوفمبر) 2024)
إصلاح الأخطاء
- تم إصلاح مشكلة تلقّي السائقين لأخطاء gRPC باستخدام الرمز "INTERNAL" ورسالة "خطأ خطير! هذا خطأ".
- تحسين داخلي لتقليل أخطاء الاتصال في تحديث الموقع الجغرافي، خاصةً عند تبديل الجهاز للشبكات وسيتم طرح هذه الميزة تدريجيًا (بدءًا من %0) بعد دمج الإصدار.
تحديثات واجهة برمجة التطبيقات
- تمت إزالة الواجهة
StatusListener
التي تم إيقافها نهائيًا.
التغييرات في التبعيات والإعدادات
- إزالة التبعية لـ
glide:cronet-integration
في ملف POM.xml - تم تعديل النطاق المسموح به لإصدارات حزمة تطوير البرامج (SDK) للتنقّل ليصبح الإصدار 5.x.
- بدءًا من الإصدار 6.0.0 من حزمة تطوير برامج (SDK) لبرنامج التشغيل على Android، يجب ترقية التطبيقات إلى Kotlin 2.0.
- أصبح targetSdk الآن هو المستوى 34 لواجهة برمجة التطبيقات. هذا شرط لجميع التطبيقات التي يتم نشرها على "متجر Google Play" اعتبارًا من آب (أغسطس) 2024. اطّلِع على استيفاء متطلبات مستوى واجهة برمجة التطبيقات المستهدَف في Google Play.
الإصدار 5.99.0 (20 أيلول/سبتمبر 2024)
إصلاح الأخطاء
- تم إصلاح مشكلة تلقّي السائقين لأخطاء gRPC باستخدام الرمز "INTERNAL" ورسالة "خطأ خطير! هذا خطأ". وسيتم طرح هذه الميزة بشكل تدريجي (بدءًا من %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 لواجهة برمجة التطبيقات أو إصدارًا أحدث. - على التطبيقات التي تستخدم Driver SDK تفعيل ميزة استخدام مكتبة Java 8. يُرجى الاطّلاع على الرابط التالي للحصول على تعليمات بشأن التحديث: 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).
الإصدار 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
التي تحتوي فقط على موقع جغرافي "خام"إصلاح مشكلة تعارض البيانات في واجهة برمجة التطبيقات ALPHA API الخاصة بميزة "نظرة عامة على المسار"
الإصدار 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 من واجهة برمجة التطبيقات.
ويعني ذلك أنه:
- إنّ حِزم Navigation SDK وDriver SDK التي تعمل على تطبيقات Android ستكون متوافقة مع الإصدار 5 من Android (المستوى 21 لواجهة برمجة التطبيقات) كحد أدنى حتى 30 حزيران (يونيو) 2023.
- بعد 30 حزيران (يونيو) 2023، لن نتيح سوى الإصدار 23 من واجهة برمجة التطبيقات لنظام التشغيل Android والإصدارات الأحدث. بعبارة أخرى، سنتوقف عن إتاحة المستوى 21 و22 من واجهة برمجة تطبيقات Android في جميع إصدارات حزمة SDK بعد هذا التاريخ. وهذا يعني أنّه لن يتم إصلاح الأخطاء المتعلّقة بنظام التشغيل Android 21 أو 22 في أي إصدار من حزمة SDK (بما في ذلك الإصدار 4.x)، ولا نضمن أن تعمل حِزم SDK بشكل صحيح.
يحلّ هذا الإشعار محلّ إشعار إيقاف الدعم لنظام التشغيل Android 21 و22 اعتبارًا من 21 حزيران (يونيو) 2021، وإشعار إيقاف الدعم لنظام التشغيل Android 23 و24 و25 اعتبارًا من 18 تشرين الأول (أكتوبر) 2021.
الإصدار 4.2.0 (8 حزيران/يونيو 2022)
تغيير في التبعية
- عليك ترقية العنصر المعتمد على حزمة تطوير البرامج (SDK) لنظام التنقّل إلى الإصدار 4.1.3.
- يتم الرجوع إلى المستوى 21 من واجهة برمجة تطبيقات Android كحد أدنى لإصدار واجهة برمجة التطبيقات المتوافق.
الإصدار 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
قبل بدء حزمة تطوير البرامج.
- تمت إضافة الدالة
setAbnormalTerminationReportingEnabled
إلىDriverApi
.
دالة getRemainingVehicleStops غير المتزامنة
- تم تغيير دالّة
getRemainingVehicleStops
DeliveryVehicleReporter
لعرض 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) متوافقة مع الإصدارات الجديدة من حِزم SDK لنظام التشغيل Android Navigation وDriver، اعتبارًا من الربع الثالث من 2022.
لن تتوافق حِزم SDK الخاصة بالتنقّل والسائق لإصدارات Android التي تم إصدارها اعتبارًا من الربع الثالث من عام 2022 إلا مع الأجهزة التي تعمل بالإصدار 26 من واجهة برمجة التطبيقات على الأقل من Android.
ستستمر إصدارات التطبيقات التي تم إنشاؤها باستخدام الإصدار 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 (الثنائيات المجزّأة)
لتبسيط عملية دمج العملاء وتسريع قدرتنا على تقديم ميزات مفيدة، سنقسّم حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android وحزمة تطوير البرامج (SDK) لبرنامج التشغيل على أجهزة Android إلى ملفّين ثنائيَين مختلفَين:
- حزمة تطوير البرامج للتنقّل على أجهزة Android، والتي ستوفّر وظائف التنقّل/التوجيه للسائقين
- حزمة تطوير برامج (SDK) للسائقين لنظام التشغيل Android، والتي ستتيح لك الاستفادة من خدمات الويب التي تتضمّن حالة لمحرك Fleet Engine من أجل تحديد مستوى تقدّم الرحلة أو المهمة وتوزيعها
يُرجى العِلم أنّ حزمة تطوير البرامج (SDK) لنظام التشغيل Android للسائقين تعتمد بشكلٍ أساسي على حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android من أجل وظائف التوجيه الأساسية.
ما هي التغييرات؟
في ما يلي التغييرات الرئيسية في الإصدار 3:
- ملفان ثنائيان بدلاً من ملف واحد
- تعريفات حِزم أكثر وضوحًا لفئات Driver SDK لنظام التشغيل Android
- تتضمّن حزمة تطوير البرامج للتنقّل على أجهزة Android حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android كأحد
أجزاء الحزمة (بدءًا من الإصدار 2 من حزمة تطوير البرامج للتنقّل على أجهزة Android).
- يتيح ذلك للمخططات وميزات التنقّل الظهور معًا على الخريطة نفسها (مثل رسم خطوط متعددة على NavigationView) ويقلل من استخدام الذاكرة لأنّه يتم استخدام خريطة واحدة بدلاً من خريطتَين.
- لا تتضمّن حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android 3.0 ميزات متطابقة تمامًا مع حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android، ولكن سيحلّ الإصدار 3.2 معظم المشاكل المذكورة هنا. اطّلِع على الإجراءات التي يمكنني اتّخاذها والحالات التي يمكنني اتّخاذها فيها لمعرفة المزيد من التفاصيل.
- يتيح لنا هذا الإجراء تسجيل المعلومات التي تُسهّل علينا تصحيح الأخطاء التي قد تواجهها.
تم أيضًا إزالة الطرق التالية في الإصدار 3، بعد أن تم وضع علامة عليها في السابق بأنّها متوقّفة نهائيًا وتتوفر لها حلول بديلة:
- تم إيقاف طُرق حزمة تطوير البرامج (SDK) التالية الخاصة بـ Nav/Driver نهائيًا في الإصدار 1.16 الذي تم إصداره في
10 آب (أغسطس) 2020، وتمّت إزالتها في الإصدار 3.0:
Waypoint#fromLatLng(*)
Waypoint#fromPlaceId(*)
Navigator#startGuidance(resumeIntent)
NavigationApi#initForegroundServiceManager(*)
- للتأكّد من اكتمال الشرح ووضوحه، يُرجى العلم أنّه تمت إزالة عدد من الطرق في أثناء عملية التحويل من الإصدار 1 إلى الإصدار 2. وكان معظم هذه التغييرات عبارة عن دمج لعدة klassen متكررة بين حزمة تطوير البرامج للتنقّل على أجهزة Android وحزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android. يُرجى الاطّلاع على دليل نقل البيانات لفهم هذه التغييرات بشكل أفضل.
الإيقاف النهائي لحِزم Driver SDK وNavigation SDK للإصدار 1.x من نظام التشغيل Android
تم إصدار الإصدار 1 من حزمة SDK لنظام التنقّل/السائق في عام 2018، وبما أنّنا سنطرح قريبًا الإصدار 3، حان وقت إيقاف الإصدار 1 نهائيًا لتجنّب عدم التوافق مع العديد من الإصدارات الرئيسية.
سيتيح لنا الوقت الذي نوفّره من خلال عدم توفير التوافق مع هذا الإصدار الإضافي توفير التوافق بشكل أفضل مع أحدث إصدار رئيسي وإنشاء المزيد من الميزات التي تُعد مهمة لعملاءنا.
وبالتالي، تم إيقاف الإصدار 1.x من حِزم تطوير البرامج (SDK) لنظام التشغيل Nav/Driver نهائيًا ولن يتم الاحتفاظ به بعد 21 حزيران (يونيو) 2022.
يُرجى تخصيص بعض الوقت للاطّلاع على آلية عمل عمليات الإيقاف النهائي في إصدارات حزمة SDK.
إيقاف حِزم SDK لتطبيقات التنقّل والسائقين على الإصدارَين 21 و22 من نظام التشغيل Android
قراءة الإعلان المُلغى
سيتوفّر الإصدار 4.0 القادم من حزمة تطوير البرامج (SDK) للتنقّل على أجهزة Android و حزمة تطوير البرامج (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 والإصدارات الأحدث، وهذا ما كان يحدث في السابق.
- لن تتمكّن من تثبيت إصدارات التطبيق التي تم إنشاؤها باستخدام الإصدار 4.x من حزمة "SDK لسائقي المركبات" لنظام التشغيل Android و"حزمة SDK لنظام التنقّل" لنظام التشغيل Android (المتوقع إطلاقه في الربع الأخير من عام 2021، ويخضع للتغيير) وبعد ذلك على الأجهزة التي تعمل بالإصدارَين 21 و22 من نظام التشغيل Android. لن يعمل الإصدار 4.x إلا على الإصدار 6.0 من نظام التشغيل Android كحد أدنى (المستوى 23 من واجهة برمجة التطبيقات)، لذا لن يتمكّن سوى السائقين الذين لديهم أجهزة تعمل بالإصدار 23 من نظام التشغيل Android والإصدارات الأحدث من تلقّي إصدارات تطبيقك التي تم إنشاؤها باستخدام الإصدار القادم من حزمة 4.x. للتذكير، يعني ذلك أنّ التغييرات المتعلقة بحزمة SDK وأي تغييرات أجريتها على التطبيق لن تصل إلى السائقين الذين لديهم أجهزة تعمل بالإصدارَين 21 و22 من نظام التشغيل Android.
في الجدول التالي، يمكنك الاطّلاع على إصدارَي حزمة تطوير البرامج Navigation SDK لنظام التشغيل Android 3 و حزمة تطوير البرامج Driver SDK لنظام التشغيل Android 3 المطلوب الترقية إليهما، بالإضافة إلى وقت توفّرهما.
ما هي ميزات منصة Driver التي تستخدمها؟ | هل تستخدم هذه الإمكانات؟ | بعد ذلك، فإنّ أوّل الإصدارات المتاحة التي يجب الترقية إليها هي... | تاريخ التوفّر المتوقّع (يخضع للتغيير) |
روابط نقل البيانات |
---|---|---|---|---|
التنقّل فقط (طُرق NavSDK) |
لا | الإصدار 3.0.1 من NavSDK | الآن | الدليل |
نعم | الإصدار 3.5 من NavSDK (متوقّع) | أيلول (سبتمبر) 2021 | ||
تتبُّع محرّك التنقّل ومجموعة المركبات (طُرق NavSDK وDriverSDK) | لا | الإصدار 3.0 من حزمة تطوير البرامج (SDK) لنظام التنقّل والإصدار 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. وبعد هذا التاريخ، لن نتمكّن من الردّ على طلبات إصلاح الأخطاء أو إضافة ميزات في الإصدار v1.x.
يُرجى تخصيص بعض الوقت لمراجعة الجدول التالي واطلاعك على [دليل نقل البيانات](/maps/documentation/navigation-sdk-android/v2/migration) لمساعدتك في التعامل مع هذه التغييرات.
ما هي الإجراءات التي يمكنني اتّخاذها بحلول هذا التاريخ؟
إذا كنت تستخدم حاليًا... | هل تستخدم هذه الإمكانات؟ | للترقية الآن | للترقية في أيلول (سبتمبر) 2021 | روابط نقل البيانات |
---|---|---|---|---|
الإصدار 1.x (لا يستخدم وظائف FleetEngine.java أو Driver) |
لا | الإصدار 3.0 من NavSDK | الدليل | |
نعم | لا يتوفّر خيار | NavSDK 3.x | ||
الإصدار 1.x (باستخدام FleetEngine.java / وظيفة Driver) |
لا | لا يتوفّر خيار | NavSDK 3.x + DriverSDK 3.x |
الدليل أعلاه، بالإضافة إلى دليل نقل بيانات الإصدار 3.0 من "السائق" المتاح عند الإصدار |
نعم |
ننصحك بإبلاغ السائقين الذين يستخدمون الأجهزة التي تعمل بالإصدارَين 21 و22 من Android بالترقية إلى إصدار أحدث من Android (الإصدار 6.0 على الأقل) قبل دمج حزمة تطوير البرامج (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
مؤقتًا.
تحسين الثبات وإصلاح الأخطاء
- تم إصلاح خطأ كان يتسبب في ظهور استثناء في حال تم محو مثيل "محرك الأسطول".
الإصدار 1.15.1 (12 أيار/مايو 2020)
الميزات
أظهر التحليل الأوّلي لبيانات الإصدار 1.15.0 تحسينات كبيرة في تسجيل المواقع الجغرافية الثابتة (تقليل المواقع الجغرافية "المتوقفة"). يسمح تصحيح هذا التصحيح بمواصلة تسجيل الموقع الجغرافي المحسّن. لم تكن مشكلة ANR مرتبطة بهذه التحسينات.
تحسين الثبات وإصلاح الأخطاء
- تم إصلاح خلل كان يؤدي أحيانًا إلى عرض خط مستقيم في بداية المسار في تطبيق المستهلك.
- تم إصلاح خلل كان يمكن أن يؤدي إلى حدوث خطأ ANR عند الإبلاغ عن المواقع الجغرافية
من خلال حزمة تطوير البرامج (SDK). وقد نتج ذلك عن
onArrival()
تحسينًا كانت عرضة لصراع القفل. تمكّنا من إعادة إنتاج أخطاء ANR بشكلٍ موثوق في بعض الحالات، وتمكّنا من التأكّد من أنّ الإصلاحات قد حلّت المشكلة. تم تشغيل التطبيق التجريبي المعدَّل لإنشاء أخطاء ANR لمدة ثماني ساعات بدون حدوث خطأ ANR بعد الإصلاح.
الإصدار 1.15.0 (23 آذار/مارس 2019)
الميزات
- تمّت إضافة حالة إرشادات التنقّل عند أحداث البدء والخروج عن المسار والوصول لتحسين تتبُّع الموقع الجغرافي للمركبة.
- تمت إضافة إمكانية مواصلة الحصول على المواقع الجغرافية التي تم التقاطها على الطريق بغض النظر عن حالة التنقّل.
- تمت إضافة معلومات إضافية عن المواقع الجغرافية التي تم التقاطها قبل التقاط الطريق، مثل الدقة.
إصلاح الأخطاء وتحسين الثبات
- تم رفع الحد الأدنى لإصدار حزمة navsdk إلى 19.
- تم إصلاح خطأ كان يتسبب في عدم الالتزام بأسماء نقاط الالتفاف ذات التنسيق lat/lng عند تعذُّر ترميز الموقع الجغرافي العكسي من جهة الخادم.
الإصدار 1.14.2 (2 شباط/فبراير 2019)
الميزات
- يمنع DriverSDK من إرسال مواقع جغرافية 0,0 إلى Fleet Engine (مدخلات أفضل لمشاركة الرحلات وتحديد المواقع الجغرافية المخصّصة للتوزيع).
- تسجيل إضافي لتحسين مشاكل الموقع الجغرافي المتوقف وخفض عمليات الاستبدال لمشاركة الرحلة
- تجاهل المكالمات المتكرّرة إلى
setLocationReportingInterval()
ما لم يتغيّر الفاصل الزمني. - تم تعديل مستندات javadoc الخاصة بطريقة
setReportingInterval()
بهدف تقليل تكرار استدعاء هذه الطريقة بمعدّل مرتفع مقارنةً بالمُدد المستخدَمة. - تحسين موثوقية الموقع الجغرافي في Api 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