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

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

2.3.0 (2 آب/أغسطس 2024)

التغييرات في واجهة برمجة التطبيقات

2.2.0 (7 أيار (مايو) 2024)

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة واجهة برمجة تطبيقات لدعم دمج Jetpack Compose. هذه ميزة تجريبية. للاطّلاع على تفاصيل حول الدمج مع Jetpack Compose، يُرجى التواصل مع ممثّلك.

2.1.0 (17 كانون الثاني/يناير 2024)

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

  • إصلاح الأعطال التي تحدث عند بدء حزمة تطوير البرامج (SDK) أكثر من مرة على مدار رحلة نشاط التطبيق

التغييرات في واجهة برمجة التطبيقات

  • يقدّم هذا القسم طريقة لاسترداد مثيل GoogleMap الذي أنشأته حزمة SDK (ConsumerGoogleMap.getGoogleMap()).
  • تعرِض واجهة برمجة التطبيقات لاسترداد نُسخ Marker التي أنشأتها حزمة تطوير البرامج (SDK) لتمثيل المركبة (ConsumerController.getConsumerMarker()).
  • تقديم واجهة برمجة تطبيقات لتلقّي آخر المعلومات المتوقّعة للعميل بشأن الوقت والمسافة أثناء ميزة "مشاركة الرحلة" (ProjectedRouteEta)

1.99.2 (3 تشرين الثاني/نوفمبر 2023)

  • إصلاح عطل يحدث عند بدء حزمة تطوير البرامج (SDK) من عملية عن بُعد، بعيدًا عن التطبيق

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

  • إصلاح خطأ يؤدي إلى اقتطاع القسم الأول من رحلة متتالية عندما يمر القسم الثاني من الرحلة على الطريق نفسها

المشاكل

  • تطرح الدالة ConsumerApi.initialize() استثناءً إذا تم استدعاؤها عند توفّر مثيل لواجهة برمجة التطبيقات. للتغلب على هذه المشكلة، عليك أولاً استدعاء ConsumerApi.getInstance() وتقييم Task الذي تم عرضه لتحديد ما إذا كان هناك مثيل من واجهة برمجة التطبيقات.

2.0.0 (15 أيلول/سبتمبر 2023)

إشعار: تغييرات قد تؤدي إلى أعطال

  • تم تعديل الحد الأدنى لمستوى واجهة برمجة التطبيقات من 21 إلى 23.

  • تعديل متطلبات إصدار حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" من الإصدار 17.0.0 إلى الإصدار 18.1.0

  • تم تعديل الحد الأدنى لمتطلبات إصدار المكتبة العادية في Kotlin من الإصدار 1.6.10 إلى الإصدار 1.9.0.

  • تحديث إصدارات متطلّبات "خدمات Google Play"

    • تم تعديل الحد الأدنى لمتطلبات إصدار مكتبة play-services-base من v18.0.1 إلى v18.2.0

    • تم تحديث الحد الأدنى لمتطلبات إصدار مكتبة الطابق السفلي من 18.0.0 إلى v18.2.0

    • تم تعديل الحد الأدنى لمتطلبات إصدار مكتبة play-services-location من الإصدار 17.0.0 إلى الإصدار 21.0.1

    • تم تحديث الحد الأدنى لمتطلبات إصدار مكتبة مهام خدمات Play من الإصدار 18.0.1 إلى الإصدار 18.0.2

  • تتم إضافة مكتبة androidx.room:room-runtime مع ضبط الحدّ الأدنى لمتطلبات الإصدار على الإصدار 2.5.2

  • تعديل إصدارات التبعيات التالية

    • تم تعديل الحد الأدنى لإصدار مكتبة android-maps-utils من الإصدار 0.4.2 إلى الإصدار 3.5.2

    • تم تعديل الحد الأدنى لمتطلبات الإصدار com.google.android.datatransport:transport-backend-cct من الإصدار 3.0.0 إلى الإصدار 3.1.9

    • يتم تحديث الحد الأدنى لمتطلبات إصدار com.google.android.datatransport:transport-runtime من v3.0.1 إلى v3.1.9.

    • يتم تحديث الحد الأدنى لمتطلبات إصدار androidx.lifecycle:lifecycle-extensions من v2.0.0 إلى v2.2.0

    • تم تعديل الحد الأدنى لمتطلبات إصدار androidx.lifecycle:lifecycle-common-java8 من الإصدار 2.0.0 إلى الإصدار 2.6.1

    • تم تعديل الحد الأدنى لمتطلبات إصدار androidx.appcompat:appcompat من الإصدار 1.0.0 إلى الإصدار 1.6.1

    • تم تعديل الحد الأدنى لإصدار androidx.fragment:fragment من v1.0.0 إلى v1.6.1

  • إزالة واجهات برمجة التطبيقات التالية التي تم إيقافها نهائيًا سابقًا: ConsumerTrip، ConsumerTripCallback، ConsumerTripManager، ConsumerTripOptions وتم استبدالها بالرموز TripModel وTripModelCallback وTripModelManager وTripModelOptions.

  • يجب أن تتضمّن التطبيقات التي تستخدم حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين targetSdkVersion من واجهة برمجة التطبيقات 31 أو أعلى أو compileSdkVersion من واجهة برمجة التطبيقات 33 أو أكبر.

  • على التطبيقات التي تستخدم حزمة Consumer SDK تفعيل ميزة التوافق مع مكتبة Java 8 . يُرجى الاطّلاع على الرابط التالي للحصول على تعليمات بشأن التحديث: https://developer.android.com/studio/write/java8-support.

  • يجب نقل التطبيقات التي تستخدم Proguard أو Dexguard إلى الإصدار R8. يُرجى الاطّلاع على https://developer.android.com/build/shrink-code للحصول على مزيد من المعلومات.

  • يجب تفعيل ميزة إزالة السكر من التطبيقات التي تستخدم حزمة Consumer SDK. اطّلِع على الرابط https://developer.android.com/studio/write/java8-support#library-desugaring للحصول على التعليمات.

  • تُعرِض طريقة ConsumerApi.initialize() الآن استثناءً إذا تم استدعاؤها عندما تكون هناك مثيل لواجهة برمجة التطبيقات تم إنشاؤه من قبل. يجب استخدام Task المعروضة من خلال ConsumerApi.getInstance() لتحديد ما إذا كانت هناك مثيل Task تم إنشاؤه مسبقًا.

إشعار: إيقاف واجهة برمجة التطبيقات نهائيًا

  • إيقاف فئات التعليقات التوضيحية Trip.TripStatus وTrip.TripType نهائيًا، وإضافة فئات التعليقات التوضيحية TripInfo.TripStatus وTripInfo.TripType بدلاً منها

    • وكجزء من هذا التغيير، تم إيقاف TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status) نهائيًا وتمت إضافة TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status) ليحلّ محلّه.

    • وكجزء من هذا التغيير، تم إيقاف TripInfo#getTripStatus() نهائيًا، وتمت إضافة TripInfo#getCurrentTripStatus() ليحلّ محلّه.

    • وكجزء من هذا التغيير، تم إيقاف TripInfo#getTripType() نهائيًا، وتمت إضافة TripInfo#getCurrentTripType() ليحلّ محلّه.

  • إيقاف فئة Trip نهائيًا

تغييرات أخرى وإصلاحات أخطاء

  • يتيح طلب أحدث عارض لحزمة تطوير البرامج (SDK) للخرائط. راجع عارض الخرائط الجديد للحصول على التفاصيل.

  • توفّر هذه الميزة توافق حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" مع الإصدارات من 18.1.0(شاملة) إلى 19.0.0(حصرية).

  • إصلاح خطأ "انتهاء الموعد النهائي" في عمليات التواصل الداخلية بين حِزم تطوير البرامج (SDK) وخلفية Google

  • إصلاح مشكلة العرض على الشاشة الصغيرة ووضع "نافذة ضمن النافذة"

دليل نقل البيانات

1.99.1 (31 آب/أغسطس 2023)

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

  • إصلاح عطل يحدث عند إتلاف نشاط أو جزء مضيف حِزم تطوير البرامج (SDK)

  • إصلاح الأعطال التي تحدث عندما تكون سمات MapView هي 0 (سواءً الارتفاع أو العرض)

  • إصلاح مشكلة الأعطال التي تحدث عند عرض الموقع الجغرافي للمركبة على مسار ملف خطوط الالتفاف

التحسينات

  • يمنع هذا الإجراء حزمة تطوير البرامج (SDK) من تعطُّل عند تثبيت التطبيق المضيف من مصدر غير معروف وعدم توفُّر الموارد المرئية التلقائية.

1.99.0 (22 حزيران/يونيو 2023)

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

  • إصلاح مشكلة التقديم على الشاشة الصغيرة وفي وضع "نافذة ضمن النافذة"

  • يعمل على إصلاح وميض المركبات أثناء مشاركة الرحلة.

1.2.1 (7 حزيران/يونيو 2023)

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

  • إصلاح خلل يؤدي إلى وميض المركبة أثناء مشاركة الرحلة

1.2.0 (21 تشرين الثاني/نوفمبر 2022)

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

  • إصلاح الخطأ الذي تسبّب في الإبلاغ عن الزيارات الفارغة في معاودة الاتصال على "onTripActiveRouteTrafficUpdated".

الميزات الجديدة

  • أصبحت "الخطوط المتعددة المراعية لحركة المرور" متاحة الآن بشكل عام.

1.1.2 (27 تشرين الأول/أكتوبر 2022)

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

  • معالجة الخلل الذي يؤدي إلى اختفاء المضلع للمسار بعد بدء JourneySharingSession أكثر من مرة لTripModel

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

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

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

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

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

الإصدار 1.1.1 (25 تموز/يوليو 2022)

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

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

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

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

الإصدار 1.0.19 (17 آذار/مارس 2022)

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

  • تم إصلاح تسرب ذاكرة في فئة ConsumerApi.

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

الحد الأدنى المتوافق مع واجهة برمجة تطبيقات Android هو 23 الآن.

التغييرات في واجهة برمجة التطبيقات

  • التغييرات في صفوف ConsumerTrip وConsumerTripManager

    • تمّت إزالة بعض أسماء الطرق لجعل معناها أكثر وضوحًا ومواءمةً مع نظام التشغيل iOS.

  • التغييرات في ConsumerTripCallback وConsumerTrip وTripInfo

    • تم تغيير بعض أسماء الفئات لتكون متطابقة مع iOS. تمّت إضافة TripModel وTirpModelManager وTripModelOptions لإيقاف ConsumerTrip وConsumerTripManager وConsumerTripOptions نهائيًا.

    • تمّت إزالة بعض أسماء الطرق. تم تعديل تعليقات JavaDoc أو إضافتها إلى methods للتعبير عن معانٍ أوضح.

    • تحسين معالجة الأخطاء

تخصيص التصميم

  • برامج تضمين الإصدار القديم

    • تم إيقاف MarkerStyleOptions وPolylineStyleOptions نهائيًا و replaced بMarkerOptions وPolylineOptions، وكلاهما تتم مشاركتهما مع حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google".

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

  • تمت إضافة ميزتَي "رصد الأعطال" و"تسجيل الأعطال".

    • تم إجراء إضافة للسماح لك بإيقاف هذه الوظيفة. وقد تم تنفيذ ذلك كجزء من جهد أكبر على مستوى منطقة جغرافية واسعة لمراقبة الأعطال.

تغييرات في المصادقة

  • أزِل الطرق غير الضرورية من واجهات المصادقة.
    • تمت إزالة مَعلمة ServiceType.

الإصدار 0.9.28 (18 أيار (مايو) 2021)

التغييرات في واجهة برمجة التطبيقات

  • تم تعديل جميع طرق ConsumerTripCallback لاستخدام TripInfo كمَعلمة .
  • تمت إضافة ConsumerTrip.isRefreshing()، التي تشير إلى ما إذا كان ConsumerTrip يتم تعديله بشكل نشط باستخدام معلومات الرحلات الجديدة من Fleet Engine.
  • تمت إضافة ConsumerTripCallback.onTripRemainingRouteDistanceUpdated().
  • تمت إضافة ConsumerTripCallback.onTripRemainingRouteUpdated().
  • استبدِل أنواع الإرجاع في Guava (ImmutableSet وImmutableList) بفئات مكافئة java.util.

  • تغييرات اسم الحزمة:

    • com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
    • com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory

    • com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip

                                  ->
                                                            com.google.android.libraries.ridesharing.consumer.model.Trip

                            -   com.google.android.libraries.ridesharing.common.model.Vehicle

                                                    ->
                                com.google.android.libraries.ridesharing.consumer.model.Vehicle

تغييرات التنفيذ

  • تم إصلاح مشكلة تعارض في المعالجة حيث يمكن أن تتعطل حزمة SDK بسبب التفاعلات مع الخريطة قبل أن تصبح جاهزة.
  • لم تعُد حزمة SDK تحتوي على نسخة غير مشفّرة من io.grpc.
  • تم إصلاح خطأ متعلّق بظهور خطوط متعددة للمرور بشكل متقطع على أجهزة معيّنة. ستتضمّن الآن شرائح الزيارات نهايات مستديرة.

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

التغييرات في واجهة برمجة التطبيقات

  • يقدّم هذا الإصدار خطوط ملفتة للانتباه باستخدام الخطوط المتعددة. - تمت إضافة TripInfo.getActiveRouteTraffic() و TripInfo.getRemainingRouteTraffic().
    • تمت إضافة ConsumerTripCallback.onTripActiveRouteTrafficUpdated() و ConsumerTripCallback.onTripRemainingRouteTrafficUpdated() للإشارة إلى حالات تغيُّر عدد الزيارات.
    • تمت إضافة PolylineStyleOptions لتخصيص عدد الزيارات (setTrafficEnabled() وsetTrafficColorNoData() setTrafficColorNormal() وsetTrafficColorSlow() setTrafficColorTrafficJam()).
    • تم الكشف عن PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION.
    • تمت إضافة TripWaypoint.getTrafficData().
    • تمت إضافة نوع البيانات TrafficData.
    • تمت إضافة ConsumerController.hideAllSessions(). لم تعُد دالة ConsumerController.showSession() تقبل القيمة null كأحد المَعلمات.

الإصدار 0.9.9 (15 تموز/يوليو 2020)

التغييرات في واجهة برمجة التطبيقات

  • هذا تغيير كبير يقدّم بنية وحدات مع صلة أوضح بين طبقة البيانات فقط (على سبيل المثال، ConsumerTripManager) وطبقة واجهة المستخدم (على سبيل المثال، JourneySharingSession). للحصول على معلومات عن نقل البيانات إلى البنية الجديدة، اطّلِع على دليل نقل البيانات باستخدام وحدات متناقلة . - يتم الآن الحصول على عنصر ConsumerTrip من ConsumerTripManager.getTrip().
    • تمت إعادة تسمية ConsumerTrip.unregisterCallback إلى ConsumerTrip.unregisterTripCallback.
    • تمت إعادة تسمية ConsumerTrip.isCallbackRegistered إلى ConsumerTrip.isTripCallbackRegistered.
    • تمت إضافة ConsumerTrip.setConsumerTripOptions() و ConsumerTrip.getConsumerTripOptions().
    • تمت إزالة ConsumerTrip.setAutoRefreshInterval().
  • تمّت إزالة واجهات برمجة التطبيقات غير المخصّصة لمشاركة الرحلات.
    • تمت إزالة خريطة كثافة المركبات.
    • تمّت إزالة حالة معاينة الرحلة.
    • تمت إزالة حالة خيار استلام الطلب.
    • تمت إزالة حالة اختيار نقطة الاستلام.
    • تمت إزالة أنواع العلامات التالية: SELECTED_PICKUP_POINT و SUGGESTED_PICKUP_POINT وHIGHLIGHTED_PICKUP_POINT و SELECTED_DROPOFF_POINT.
  • تم تغيير OnConsumerMarkerClickCallback وConsumerMapReadyCallback من واجهات إلى فئات مجردة.
  • تمت إضافة ConsumerController.getCameraUpdate() ConsumerController.isAutoCameraEnabled() ConsumerController.enableAutoCamera().
  • تمت إزالة رمز التطبيق المصغّر المخصّص للإجراءات السريعة والأساليب المرتبطة به (ConsumerController.isMyLocationFabEnabled و ConsumerController.setMyLocationFabEnabled).

تغييرات التنفيذ

  • إنّ ConsumerTripCallback، سواء كانت مسجَّلة باستخدام LifecycleOwner أو بدونها، لا يتم إلغاؤها تلقائيًا في TripStatus.COMPLETE أو TripStatus.CANCELED.
  • تكون ميزة "الكاميرا التلقائية" مفعّلة الآن بشكل تلقائي ولا تعيد تفعيل نفسها أو إيقافها أبدًا. في السابق، تمت إعادة تفعيل Auto Camera تلقائيًا في TripStatus.ARRIVED_AT_PICKUP وأوقفت نفسها عندما تفاعل المستخدم مع الخريطة أثناء مشاركة الرحلة.
  • تم إجراء التحسينات التالية على الميمَج المتحرّك لمركبة مشاركة الرحلة:
    • يعالج الآن المخطّط المتحرك لمشاركة الرحلة الموقف الذي قد تعود فيه المركبة بشكل شرعي على مسار سبق أن تم عبوره.
    • ستتحرّك المركبة الآن بشكل مستقيم بدلاً من استخدام أسلوب التداخل بين النقاط في المسار عند تحديد أنّه مناسب من الناحية الحسابية.
  • لم تعد أذونات FINE_LOCATION مطلوبة.

التغييرات الأخرى

  • تم تعديل إصدارات التبعيات التالية:
    • com.google.android.datatransport:transport-api:2.2.0
    • com.google.android.datatransport:transport-backend-cct:2.2.0
    • com.google.android.datatransport:transport-runtime:2.2.0

الإصدار 0.9.1 (23 آذار/مارس 2020)

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة TripInfo.getVehicleId() وTripInfo.getNumberOfPassengers() TripInfo.getIntermediateDestinationIndex() TripInfo.getTripActiveRoute() وTripInfo.getTripRemainingRoute().
  • تمت إضافة فئة options المستخدَمة أثناء بدء ConsumerApi التي تتيح ضبط عنوان FleetEngine ديناميكيًا. إذا لم يتمّ استدعاء واجهة برمجة التطبيقات باستخدام قيمة FleetEngine، ستحاول استرجاعها من ملف بيان Android، أو ستستخدِم القيمة التلقائية في حال عدم توفّرها.

التحسينات

  • لا يتم عرض المسار المتعدد الأضلاع عندما تكون حالة الرحلة ARRIVED_AT_PICKUP.
  • تم تحسين ميزة تتبُّع المركبات التي تخرج عن المسار (تتطلب DriverSDK 1.15):
    • لا تُعيد ميزة تتبُّع المركبات وضع المركبة إلى المسار عندما تتجاوز المركبة نقطة الاستلام.
    • وتتيح تتبّع المركبات إمكانية عرض المركبة خارج الطريق، على سبيل المثال، في مواقف السيارات غير المعيَّنة.
  • يتم تحديث رمز المركبة الآن عندما لا تتطابق وجهة السائق مع الوجهة في Fleet Engine.

الإصدار 0.8.6 (16 كانون الأول/ديسمبر 2019)

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة TripInfo.getVehicleLocation().

  • لم تعُد البطاقة "ConsumerMapView" نهائية.

التغييرات في طريقة التنفيذ

  • يتم الآن احتساب المسافة المتبقية في القسم النشط باستخدام المسافة من الخادم (المسافة التي أبلغ عنها السائق + المسار الثابت حيثما ينطبق ذلك) بدلاً من الربط المحلي. يؤدّي هذا التغيير إلى الحصول على قيم أكثر دقة للمسافة المتبقية.

التغييرات الأخرى

  • يجب استخدام تبعيات جديدة. اطّلِع على ملف ‎.pom للحصول على التفاصيل.

    • com.google.android.datatransport:transport-api:2.0.0
    • com.google.android.datatransport:transport-backend-cct:2.0.2
    • com.google.android.datatransport:transport-runtime:2.0.0

  • تمت إضافة سجلات لوقت استجابة طلب الرحلة.

  • تمّت إضافة سجلّات لأخطاء استجابة الرحلات.

ملاحظات

  • منذ الإصدار 0.8.1، أصبحت حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين لنظام التشغيل Android متوفرة كأرشيف مضغوط مضغوط. للحصول على معلومات حول كيفية إزالة تحديد مصدرها، راجِع Jetifier: الوضع العكسي.

الإصدار 0.8.1 (13 أيلول/سبتمبر 2019)

الميزات الجديدة

التغييرات في واجهة برمجة التطبيقات

  • تمت إضافة ConsumerController.disableAutoCamera() كدالة معاكسة للدالة centerMapForState().

  • تعرض VehicleLocation.getUpdateTime() الآن قيمة Long تمثّل علامة التنسيق الزمني (بالمللي ثانية).

  • تم تبسيط واجهة AuthTokenFactory لعرض طريقة واحدة لإنشاء الرموز المميّزة. تم تغيير AuthTokenFactory من واجهة إلى صفّ مجرد لتفعيل التوافق مع الإصدارات القديمة في Java7. إنّ هذا التغيير متوافق مع الإصدارات القديمة، ولكن تم إيقاف الطرق القديمة لإنشاء رمز أمان الخدمة الفردي نهائيًا، وسيتم إزالتها في النهاية.

التغييرات في طريقة التنفيذ

  • تتمركز مواد العرض الآن في مركز الرمز، مع إزالة إزاحة الظل.

  • من setState إلى JOURNEY_SHARING onStartTripMonitoring() بدلاً من انتظار حالة "الرحلة" الخاضعة للمراقبة.

  • تعرِض هذه السمة دائمًا بيانات تحديث بيانات الرحلة الأولى، حتى إذا كانت بيانات الرحلة غير متّسقة.

  • تمت إضافة Android Map Utils كملحق مقدَّم.

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

  • تم إصلاح بنية تصدير proguard المعطّلة لخدمة grpc keep.

الإصدار 0.7.0 (7 آب/أغسطس 2019)

الميزات الجديدة

  • إتاحة ميزة "مشاركة الرحلة" لجهات متعددة

التغييرات في واجهة برمجة التطبيقات

  • طرق جديدة لـ ConsumerTripCallback

    • onTripIntermediateDestinationsUpdated().
    • onTripETAToNextTripWaypointUpdated().

  • طرق جديدة ConsumerController

    • getIntermediateDestinations().
    • setIntermediateDestinations(List<TerminalLocation> intermediateDestinations).

  • TripStatuses جديدة.

    • TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION.
    • TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION.

  • وظائف جديدة للحصول على TripWaypoint

    • getETAMillis().
    • getDistanceMeters().

  • تمت إضافة الصف TripInfo.

    • يمكنك الحصول على TripInfo للرحلة النشطة باستخدام ConsumerTripManager.getActiveTripInfo().

  • تمت إضافة WaypointType.INTERMEDIATE_DESTINATION.

  • تمت إضافة MarkerType.TRIP_INTERMEDIATE_DESTINATION.

  • تم إنشاء ConsumerMapState.JOURNEY_SHARING من ConsumerMapStates ENROUTE_TO_PICKUP وARRIVED_AT_PICKUP وENROUTE_TO_DROPOFF و COMPLETE.

    • تم تعديل StateChangeCallbacks.

    • تمت إضافة onStateJourneySharing().

    • تمت إزالة onStateWaitingForPickup() وonStateDriverArrived() onStateEnroute() وonStateEndofTrip().

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

  • تم إصلاح خلل في عدم اقتطاع المسار إلى موقع المركبة عند بدء monitoringرحلة في منتصف رحلة نشطة (وليس في بداية المسار).

  • تم إصلاح خطأ في عدم استدعاء عمليات استدعاء الرحلات للمستمعِين المسجَّلين في Tripmanager بعد أن جلب Tripmanager بيانات الرحلة.

  • لا يتضمّن تكبير/تصغير الكاميرا الآن سوى المسار النشط ونقطة الطريق التالية للرحلة (نقطة الطريق التي تنتمي إلى الرحلة). حتى إذا كانت الساق المتبقية مرئية، فلن يتضمنها التكبير أو التصغير أبدًا. في السابق، كانت نقطة الإرجاع مضمّنة في التكبير عندما كانت المركبة في طريقها إلى نقطة الاستلام أو عند وصولها إلى نقطة الاستلام. لم يعُد هذا صحيحًا.

التحسينات

  • تعبئة نقطة التوقف المتبقية الأولى ببيانات "السائق" (يتم عرض قائمة نقاط التوقف المتبقية من ConsumerTripCallback.onTripRemainingWaypointsUpdated وTripInfo.getRemainingWaypoints().

  • عدِّل جميع أوقات الوصول المقدَّرة المتبقية إلى نقاط الطريق عند تغيير وقت الوصول المقدَّر إلى نقطة الطريق الأولى في القائمة.

  • إعادة تفعيل ميزة "الكاميرا التلقائية" عند وصول السائق فقط في السابق، كانت تتم إعادة ضبط ميزة autocamera على "مفعّلة" عند تغيير حالة الرحلة. لا تزال الكاميرا التلقائية مفعّلة تلقائيًا. ولن تتم إعادة تفعيل الكاميرا التلقائية في حال ضبط رحلة نشطة جديدة بدون إجراء مكالمة جديدة مع "startTripMonitoring()".

الإصدار 0.6.1 (26 حزيران (يونيو) 2019)

الميزات الجديدة

  • إتاحة ميزة "مشاركة الرحلة" في ميزة "التنقّل بالسيارة"

التغييرات في واجهة برمجة التطبيقات

  • يعرض ConsumerController.getConsumerMapStyle() الآن ConsumerMapStyle بدلاً من Task<ConsumerMapStyle>.

  • تمت إضافة PolylineStyle.setZIndex().

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

  • لا تظهر الرسوم المتحركة للمسار الآن إلا عندما يكون جزء المسار متزامنًا، ما يؤدي إلى تحسين تجربة المستخدم.

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

  • تم إصلاح خطأ كان يتسبب في ظهور المركبة في بداية المسار بدلاً من موقعها الجغرافي المحدَّث عند بدء مراقبة الرحلة في منتصف رحلة نشطة.

  • عرض الخط المتعدّد الأضلاع للمَعلمات النشطة للمَعلمات فوق المَعلمات المتبقية عندما تتعاطف

التحسينات

  • الآن، اعرض فئة gRPC Status باستخدام طرق غير مشوشة.

الإصدار 0.5.1.01 (17 أيار (مايو) 2019)

الميزات الجديدة

  • إتاحة ميزة "مشاركة الرحلة" بشكل متتالٍ

التغييرات في واجهة برمجة التطبيقات

  • فئة ConsumerController جديدة.

PolylineType

القيمة القديمة القيمة الجديدة
TRIP_PREVIEW_AUTO_ROUTE PREVIEW_AUTO_ROUTE
TRIP_PREVIEW_TAXI_ROUTE PREVIEW_TAXI_ROUTE
TRIP_PREVIEW_TRUCK_ROUTE PREVIEW_TRUCK_ROUTE
TRIP_PREVIEW_TWO_WHEELER_ROUTE PREVIEW_TWO_WHEELER_ROUTE
TRIP_ROUTE ACTIVE_ROUTE
REMAINING_ROUTE

ConsumerTripCallback

القيمة القديمة القيمة الجديدة
onTripRouteUpdated onTripActiveRouteUpdated
onTripRemainingDistanceUpdated onTripActiveRouteRemainingDistanceUpdated
onTripRemainingWaypointsUpdated()

ConsumerController

  • يمكنك الآن ضبط عمليات معاودة الاتصال للولايات بدون إدخال الولاية.
الطريقة معاودة الاتصال
startPickupSelection setPickupSelectionCallback
startDropoffSelection setDropoffSelectionCallback
startTripPreview setTripPreviewSelectionCallback
  • يتيح لك ConsumerController.setLanguage(String languageCode) ضبط اللغة المستخدَمة في طلبات FleetEngine (لأوصاف نقطة الاستلام، على سبيل المثال).

التحسينات

  • تحتوي حالة اختيار الانسحاب الآن على دبوس قابل للسحب.
  • تمت إزالة الصورة المتحركة للكاميرا في الحالة INITIALIZE.
  • تم استبدال ManagedChannelBuilder بـ AndroidChannelBuilder.