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

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

الإصدار 5.0.0 (12 أيلول/سبتمبر 2023)

التغييرات في التبعية والضبط

• تم تحديث حزمة SDK للتنقل إلى الإصدار 5.x.
• تمت ترقية minSdkVersion إلى واجهة برمجة التطبيقات 23.
• تمت ترقية إصدار Kotlin إلى 1.9.0.
• تمت إضافة الاعتماد على الغرفة.
• يجب أن تحتوي التطبيقات التي تستخدم حزمة تطوير البرامج (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 للحصول على تعليمات.

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

• تم إصلاح المشكلة المتعلقة بتعطيل مزامنة AppLocationTracking.
• تم تقديم واجهة 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 التي تحتوي على "Raw" فقط الموقع.

• إصلاح حالة السباق في "نظرة عامة على المسار" 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.

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

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

يُلغي هذا الإشعار إشعار توقُّف التطبيق عن العمل في نظامَي التشغيل Android 21 وAndroid 22 اعتبارًا من حزيران (يونيو). 21 و2021 وتوقُّف Android 23 و24 و25 عن العمل بدءًا من 18 تشرين الأول (أكتوبر) 2021.

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

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

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

الإصدار 4.1.0 (28 نيسان/أبريل 2022)

تحديثات واجهة برمجة التطبيقات

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

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

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

تحديثات واجهة برمجة التطبيقات

في هذا الإصدار، تم تحديث حزمة تطوير البرامج (SDK) لبرنامج التشغيل Android وفقًا لما يلي: التغييرات.

تغيير في AutomotiveStops API

يشير VehicleStop عنصر الآن إلى قائمة من TaskInfo كائنات بدلاً من قائمة Task الأخرى. إذا كنت بحاجة إلى حالة المهمة، نشجّعك على تتبّعه في رمز تطبيقك.

• تمت إضافة صف جديد: TaskInfo

• تم استبدال دالة getTasks في VehicleStop بـ getTaskInfoList الأخرى.

• تم استبدال دالة setTasks في VehicleStop.Builder بـ setTaskInfoList الأخرى.

مراقبة الأعطال

تمت إضافة ميزة "رصد الأعطال" وإعداد التقارير عنها للمساعدة في تحسين ثبات حِزم SDK. هذه الميزة مُفعَّلة تلقائيًا، ولكن يمكنك إيقافها عند الاتصال setAbnormalTerminationReportingEnabled() وتمريره بقيمة false قبل إعداد حزمة SDK

• تمت إضافة setAbnormalTerminationReportingEnabled إلى DriverApi.

غير متزامن getRemainingVehicleStops

• تمّ التغيير DeliveryVehicleReporter getRemainingVehicleStops لإرجاع Future<List<VehicleStop>> بدلاً من List<VehicleStop>.

المصادقة

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

• تمت إزالة "ServiceType" من AuthTokenContext

• تمت إزالة "getServiceType()" من AuthTokenContext

• تمت إزالة "setServiceType" من AuthTokenContext.Builder

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

الإصدار 3.0.4 (28 تموز/يوليو 2021)

الميزات

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

تحديثات واجهة برمجة التطبيقات

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

RidesharingDriverApi.getDriverSdkVersion()

إصلاح الأخطاء والثبات

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

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

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

ستصبح Nav/Driver SDK for Android (حزمة SDK للتنقّل في Android v3.x) وحزمة Drive SDK لنظام التشغيل Android v3.x لنظام التشغيل Android (ملفات ثنائية مقسَّمة).

لتبسيط تكامل العملاء وتسريع قدرتنا على تقديم الأخرى، فإننا نقسم حزمة التنقل SDK لنظام التشغيل Android برنامج التشغيل SDK لنظام التشغيل Android في برنامجين ثنائيين مختلفين:

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

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

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

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

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

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

تم إطلاق الإصدار 1 من حزمة Nav/Driver SDK في 2018، وسنطرح قريبًا إصداراتنا الثالثة. إصداره، حان الوقت لإيقاف الإصدار 1 نهائيًا لتجنب عدم استدامة يدعم العديد من الإصدارات الرئيسية.

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

وبالتالي، تم إيقاف الإصدار 1.x من Nav/Driver SDK نهائيًا ولن تتم صيانته بعد الآن. بعد 21 حزيران (يونيو) 2022.

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

إنهاء الدعم للإصدارين 21 و22 من حزمة تطوير البرامج (SDK) للتنقّل وDrive

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

تحديثات واجهة برمجة التطبيقات

• تشترك حزمة Driver SDK الآن في حزمة التنقل (SDK) للحصول على تحديثات حركة المرور، التي يتم إرسالها إلى واجهة برمجة تطبيقات Fleet Engine.

إصلاح الأخطاء والثبات

• تم إصلاح تعطُّل وقت تشغيل 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) لبرنامج التشغيل.