נתוני גרסה של Consumer SDK עבור Android

בקטע הזה מפורטים נתוני הגרסה של Consumer SDK ל-Android.

הודעה: הקפאת התמיכה ברמות API‏ 23, 24 ו-25

בהתאם למדיניות התמיכה בגרסאות של מערכות הפעלה לנייד, אנחנו מפסיקים את התמיכה ב-Android 6 ו-7 (רמת API‏ 23, 24 ו-25) בגרסאות ראשיות עתידיות של Consumer SDK ל-Android.

גרסאות של Consumer SDK ל-Android שיושקו החל מהרבעון הרביעי של 2025 יתמכו ב-Android 8 (רמת API‏ 26) ומעלה. גרסאות קודמות של SDK ימשיכו לתמוך ב-Android 6 וב-Android 7.

אם לא מצוין מספר גרסה בתלויות, סביבת הפיתוח המשולבת (IDE) תטען את הגרסה החדשה ביותר של ה-SDK, וגרסאות חדשות של האפליקציה לא יתמכו ב-Android 6 וב-Android 7.

כדי לשלוט במועד שבו מעלים את מערכת ההפעלה המינימלית הנתמכת לגרסאות חדשות של האפליקציה, צריך לציין גרסה של Consumer SDK ל-Android בתלות בגרסת ה-build של האפליקציה.

‫4.1.0 (26 במאי 2026)

  • שיפורים פנימיים: העברנו את האחסון הפנימי של הנתונים ל-Jetpack DataStore.

שינויים בהגדרות ובתלות

  • שודרגה גרסת התלות של Kotlin לגרסה v2.3.0.
  • שודרג פלאגין של Android Gradle לגרסה 8.13.2.
  • שודרגה גרסת Gradle ל-8.13.
  • שדרגנו את ספריית Desugar לגרסה 2.1.5.
  • הועלתה גרסת Maps SDK ל-20.0.0 ועודכנו יחסי התלות הבאים של GMS Core:
    • play-services-location: 21.3.0
    • play-services-tasks: 18.4.1
    • play-services-common: 18.1.0
    • play-services-basement: 18.1.0
  • נוספו יחסי תלות של Jetpack Datastore‏ (androidx.datastore:datastore-core:1.2.0, androidx.datastore:datastore-guava:1.2.0).

‫4.0.0 (3 באוקטובר 2025)

  • שיפורים פנימיים.

‫3.2.0 (26 ביוני 2025)

  • שיפורים ברישום הפנימי ביומן.

שינויים בהגדרות ובתלות

  • החל מגרסה 3.2.0 של Consumer SDK ל-Android, האפליקציות צריכות לשדרג ל-Kotlin 2.1.

תיקוני באגים

  • שימוש באורך הקו הפוליגוני במקום במרחק האווירי לצורך החלטות לגבי אנימציה פנימית.

‫3.1.0 (10 במרץ 2025)

  • שיפורים ברישום נתונים פנימי.

‫3.0.0 (6 בדצמבר 2024)

שינויים בהגדרות ובתלות

‫2.99.0 (25 בנובמבר 2024)

תיקוני באגים

  • תוקנה שגיאת ANR שמתרחשת כשנדרש יותר מדי זמן להפעלה של ConsumerApi.cleanUp(). ההשקה תתבצע בהדרגה (החל מ-0%) אחרי שהגרסה תוטמע.
  • תוקנה הבעיה שבה נהגים קיבלו שגיאות gRPC עם הקוד INTERNAL וההודעה Panic! זו שגיאה!". ההשקה תתבצע בהדרגה (החל מ-0%) אחרי שהגרסה תוטמע.

‫2.3.0 (2 באוגוסט 2024)

שינויים ב-API

  • להוסיף תמיכה בעיצוב מפות מבוסס-ענן, שמאפשר ליצור חוויית שימוש במפת דרכים בהתאמה אישית למשתמשים שלכם בלי לעדכן את הקוד של האפליקציות בכל פעם שאתם משנים את סגנון המפה. מידע נוסף זמין במאמר בנושא עיצוב המפה באמצעות עיצוב מפות מבוסס-ענן.

  • מוסיפים את השיטה getServerTimeMillis() אל VehicleLocation כדי לקבוע את השעה שבה התקבל עדכון לגבי מיקום על ידי Fleet Engine.

‫2.2.0 (7 במאי 2024)

שינויים ב-API

  • הוספנו API לתמיכה בשילוב של Jetpack Compose. זו תכונה ניסיונית. לפרטים על שילוב עם Jetpack Compose, אפשר לפנות לנציג שלכם.

‫2.1.0 (17 בינואר 2024)

תיקוני באגים

  • תיקון קריסה שמתרחשת כשמפעילים את ה-SDK יותר מפעם אחת במהלך מחזור החיים של האפליקציה.

שינויים ב-API

  • הוספנו שיטה לאחזור המופע GoogleMap שנוצר על ידי ה-SDK (ConsumerGoogleMap.getGoogleMap()).
  • הוספנו API לאחזור מופעי Marker שנוצרו על ידי ה-SDK כדי לייצג את הרכב (ConsumerController.getConsumerMarker()).
  • הוספנו API לקבלת עדכונים מתוכננים של לקוחות לגבי זמן ומרחק במהלך שיתוף המסלול (ProjectedRouteEta).

‫1.99.2 (3 בנובמבר 2023)

  • תיקון קריסה שמתרחשת כשמפעילים את ה-SDK מתהליך מרוחק, בנפרד מהאפליקציה.

  • תוקן קראש שמתרחש בזמן הפעלת אנימציה של המצלמה, כשאין מספיק מקום אנכי או אופקי לריווח הפנימי. הבעיה הזו מתרחשת רק במעבד התצוגה העדכני של המפות.

  • תוקן באג שגורם לכך שהקטע הראשון של נסיעה הלוך ושוב נחתך כשנוסעים באותו כביש גם בקטע השני.

בעיות

  • הפונקציה ConsumerApi.initialize() מקפיצה הודעת שגיאה אם מפעילים אותה כשכבר קיים מופע של API. כדי לעקוף את הבעיה, קודם מפעילים את ConsumerApi.getInstance() ומעריכים את הערך המוחזר Task כדי לקבוע אם כבר קיים מופע API.

‫2.0.0 (15 בספטמבר 2023)

הודעה: שינויים בתוכנה שעלולים לגרום לכשלים

  • הדרישה לרמת API מינימלית עודכנה מ-21 ל-23.

  • עדכון הדרישה לגרסת Maps SDK מגרסה 17.0.0 לגרסה 18.1.0

  • הגרסה המינימלית הנדרשת של ספריית Kotlin הרגילה עודכנה מגרסה 1.6.10 לגרסה 1.9.0

  • עדכון הגרסאות של התלויות ב-Google Play Services

    • הגרסה המינימלית הנדרשת של ספריית play-services-base עודכנה מגרסה 18.0.1 לגרסה 18.2.0

    • הדרישה לגבי הגרסה המינימלית של ספריית play-services-basement עודכנה מגרסה 18.0.0 לגרסה 18.2.0

    • הגרסה המינימלית הנדרשת של הספרייה play-services-location עודכנה מגרסה 17.0.0 לגרסה 21.0.1

    • הגרסה המינימלית הנדרשת של ספריית play-services-tasks עודכנה מגרסה 18.0.1 לגרסה 18.0.2

  • הוספת הספרייה androidx.room:room-runtime עם דרישת סף לגרסה 2.5.2 ומעלה

  • מעדכנים את הגרסאות של יחסי התלות הבאים

    • הגרסה המינימלית הנדרשת של ספריית android-maps-utils עודכנה מגרסה v0.4.2 לגרסה v3.5.2

    • הדרישה לגבי הגרסה המינימלית של com.google.android.datatransport:transport-backend-cct עודכנה מגרסה 3.0.0 לגרסה 3.1.9

    • הדרישה המינימלית של com.google.android.datatransport:transport-runtime עודכנה מגרסה 3.0.1 לגרסה 3.1.9

    • הגרסה המינימלית שנדרשת של androidx.lifecycle:lifecycle-extensions עודכנה מגרסה 2.0.0 לגרסה 2.2.0

    • הגרסה המינימלית הנדרשת של androidx.lifecycle:lifecycle-common-java8 עודכנה מגרסה 2.0.0 לגרסה 2.6.1

    • הגרסה המינימלית הנדרשת של androidx.appcompat:appcompat עודכנה מגרסה v1.0.0 לגרסה v1.6.1

    • הגרסה המינימלית הנדרשת של androidx.fragment:fragment עודכנה מגרסה v1.0.0 לגרסה v1.6.1

  • הוסרו ממשקי ה-API הבאים שהוצאו משימוש בעבר: ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions. הם הוחלפו ב-TripModel, ‏ TripModelCallback, ‏ TripModelManager ו-TripModelOptions.

  • אפליקציות שמשתמשות ב-Consumer SDK צריכות עכשיו להיות בגרסה targetSdkVersion של API 31 ומעלה, או בגרסה compileSdkVersion של API 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 צריך להפעיל desugaring. הוראות מפורטות זמינות בכתובת https://developer.android.com/studio/write/java8-support#library-desugaring.

  • ה-method‏ ConsumerApi.initialize() זורק עכשיו חריג אם הוא מופעל כשכבר נוצר מופע API. צריך להשתמש ב-Task שמוחזר על ידי ConsumerApi.getInstance() כדי לקבוע אם נוצר מופע API לפני כן.

הודעה: הוצאה משימוש של ממשקי API

  • הוצאו משימוש מחלקות ההערות 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.

שינויים אחרים ותיקוני באגים

  • תמיכה בבקשה למרנדר העדכני ביותר של Maps SDK. פרטים נוספים זמינים במאמר בנושא מערכת חדשה לעיבוד מפות.

  • התמיכה בטווח הגרסאות של Maps SDK היא מגרסה 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)

תיקוני באגים

  • תוקן באג שגרם לדיווח על תנועה ריקה בקריאה החוזרת (callback) של onTripActiveRouteTrafficUpdated.

תכונות חדשות

  • התכונה 'קווי פוליגון עם נתונים על תנועת הגולשים' זמינה עכשיו לכלל המשתמשים.

‫1.1.2 (27 באוקטובר 2022)

תיקוני באגים

  • תוקן באג שגורם לקו הפוליגוני של המסלול להיעלם אחרי שמתחילים JourneySharingSession יותר מפעם אחת עבור TripModel.

הודעה: הקפאת התמיכה ב-Android 5‏ (25 ביולי 2022)

בגרסה 1.1.1 של ה-SDK, אנחנו מספקים תמיכה למשך שנה נוספת באפליקציות שפועלות ב-Android 5, גם ברמות API‏ 21 ו-22.

מה זה אומר:

  • ערכת Consumer SDK שפועלת באפליקציות ל-Android תתמוך בגרסה מינימלית של Android 5 (רמת API ‏21) עד 30 ביוני 2023.

  • אחרי 30 ביוני 2023, נתמוך רק ב-Android API ברמה 23 ומעלה. במילים אחרות, אחרי התאריך הזה נפסיק לתמוך ברמות API‏ 21 ו-22 ב-Android בכל גרסאות ה-SDK. המשמעות היא שלא יתוקנו באגים שקשורים ל-Android 21 או ל-Android 22 בכל גרסה של SDK (כולל גרסה 4.x), ואין לנו אפשרות להבטיח שערכות ה-SDK יפעלו בצורה תקינה.

‫v1.1.1‏ (25 ביולי 2022)

שינוי בתלות

  • מורידה את רמת ה-API המינימלית הנתמכת ב-Android ל-21.

גרסה 1.1.0 (28 באפריל 2022)

  • שיפורים פנימיים.

גרסה 1.0.19 (17 במרץ 2022)

תיקוני באגים

  • תוקנה דליפת זיכרון במחלקה ConsumerApi.

גרסה 1.0.14 (30 בנובמבר 2021)

רמת ה-API המינימלית של Android שנתמכת עכשיו היא 23.

שינויים ב-API

  • שינויים במחלקות ConsumerTrip ו-ConsumerTripManager.

    • השמות של חלק מהשיטות השתנו ועכשיו הם ברורים יותר, וגם תואמים לפלטפורמת iOS.

  • שינויים ב-ConsumerTripCallback, ב-ConsumerTrip וב-TripInfo.

    • השמות של חלק מהמחלקות השתנו כדי ליצור שוויון עם iOS. השקנו את TripModel,‏ TirpModelManager ו-TripModelOptions כדי להוציא משימוש את ConsumerTrip,‏ ConsumerTripManager ו-ConsumerTripOptions.

    • שינינו את השמות של חלק מהשיטות. תוקנו או נוספו תגובות JavaDoc לשיטות כדי להעביר משמעויות ברורות יותר.

    • שיפרנו את הטיפול בשגיאות.

התאמה אישית של הסגנון

  • רכיבי wrapper מדור קודם שהוצאו משימוש

    • הפסקנו לתמוך ב-MarkerStyleOptions וב-PolylineStyleOptions והחלפנו אותם ב-MarkerOptions וב-PolylineOptions, ששניהם משותפים עם Maps SDK.

מעקב אחרי קריסות

  • נוספו זיהוי קריסות ורישום ביומן.

    • הוספנו אפשרות להפסיק את השימוש בפונקציונליות הזו. הפעולה הזו בוצעה כחלק ממאמץ רחב יותר לניטור קריסות ב-Geo.

שינויים באימות

  • מסירים שיטות מיותרות מממשקי האימות.
    • הסרנו את הפרמטר ServiceType.

גרסה 0.9.28 (18 במאי 2021)

שינויים ב-API

  • כל השיטות של 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.
  • תוקן באג שגרם להבהוב של קווי מתאר של תנועה במכשירים מסוימים. מעכשיו, לקטעי תנועה יהיו קצוות מעוגלים.

‫v0.9.15 (7 באוקטובר 2020)

שינויים ב-API

  • בגרסה הזו אנחנו משיקים את הקווים הפוליגוניים שמבוססים על נתוני תנועה. ‫- הוספת את 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 כארגומנט.

‫v0.9.9‏ (15 ביולי 2020)

שינויים ב-API

  • זהו שינוי משמעותי שכולל ארכיטקטורה מודולרית עם קשר ברור יותר בין שכבת הנתונים בלבד (לדוגמה, ConsumerTripManager) לבין שכבת ממשק המשתמש (לדוגמה, JourneySharingSession). מידע על מעבר לארכיטקטורה החדשה זמין במדריך להעברה של מודולריזציה. - האובייקט ConsumerTrip מתקבל עכשיו מ-ConsumerTripManager.getTrip().
    • השם של ConsumerTrip.unregisterCallback השתנה לשם ConsumerTrip.unregisterTripCallback.
    • השם של ConsumerTrip.isCallbackRegistered השתנה לשם ConsumerTrip.isTripCallbackRegistered.
    • הוספנו את ConsumerTrip.setConsumerTripOptions() ואת ConsumerTrip.getConsumerTripOptions().
    • בוצעה הסרה של ConsumerTrip.setAutoRefreshInterval().
  • הסרנו ממשקי API לשיתוף נסיעות.
    • הוסרה מפת צפיפות כלי הרכב.
    • מצב התצוגה המקדימה של הנסיעה הוסר.
    • הוסר מצב הבחירה של איסוף עצמי.
    • הוסר מצב הבחירה של נקודת המסירה.
    • הוסרו סוגי התגים הבאים: SELECTED_PICKUP_POINT,‏ SUGGESTED_PICKUP_POINT,‏ HIGHLIGHTED_PICKUP_POINT ו-SELECTED_DROPOFF_POINT.
  • השינוי שבוצע הוא ב-OnConsumerMarkerClickCallback וב-ConsumerMapReadyCallback, מ-interfaces ל-abstract classes.
  • הוספת את ConsumerController.getCameraUpdate(),‏ ConsumerController.isAutoCameraEnabled() ו-ConsumerController.enableAutoCamera().
  • הוסר ה-FAB המותאם אישית וה-methods המשויכים שלו (ConsumerController.isMyLocationFabEnabled ו-ConsumerController.setMyLocationFabEnabled).

שינויים בהטמעה

  • ConsumerTripCallback, בין אם הוא רשום עם LifecycleOwner ובין אם לא, לא מבטל יותר את הרישום באופן אוטומטי ב-TripStatus.COMPLETE או ב-TripStatus.CANCELED.
  • ההגדרה 'מצלמה אוטומטית' מופעלת עכשיו כברירת מחדל, והיא לא מופעלת או מושבתת מעצמה. בעבר, AutoCamera הופעלה מחדש באופן אוטומטי ב-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

v0.9.1 (23 במרץ 2020)

שינויים ב-API

  • נוספו TripInfo.getVehicleId(),‏ TripInfo.getNumberOfPassengers(), TripInfo.getIntermediateDestinationIndex(), TripInfo.getTripActiveRoute() ו-TripInfo.getTripRemainingRoute().
  • נוספה מחלקת options שמשמשת במהלך ההפעלה של ConsumerApi ומאפשרת להגדיר את הכתובת FleetEngine באופן דינמי. אם לא קוראים ל-API עם ערך FleetEngine, הוא מנסה לאחזר אותו מקובץ המניפסט של Android, או חוזר לערך ברירת המחדל.

שיפורים

  • קו הפוליגון של המסלול לא מוצג כשסטטוס הנסיעה הוא ARRIVED_AT_PICKUP.
  • שיפרנו את המעקב אחרי רכבים שלא נמצאים במסלול (נדרשת גרסה DriverSDK 1.15):
    • מעקב אחר הרכב לא מצמיד את הרכב למסלול כשהרכב חולף על פני נקודת האיסוף.
    • מעקב אחרי כלי רכב מאפשר להציג את כלי הרכב מחוץ לכביש, למשל בחניונים שלא מופיעים במפה.
  • סמל הרכב מתעדכן עכשיו כשהיעד של הנהג לא תואם ליעד ב-Fleet Engine.

גרסה 0.8.6 (16 בדצמבר 2019)

שינויים ב-API

  • נוסף 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 מגיע כארכיון zip שעבר המרה ל-Jetpack. במאמר Jetifier: מצב הפוך מוסבר איך להסיר את Jetifier.

גרסה 0.8.1 (13 בספטמבר 2019)

תכונות חדשות

שינויים ב-API

  • נוספה הפונקציה ConsumerController.disableAutoCamera() כפונקציה ההפוכה ל-centerMapForState().

  • הפונקציה VehicleLocation.getUpdateTime() מחזירה עכשיו ערך Long שמייצג את חותמת הזמן (באלפיות השנייה).

  • ממשק AuthTokenFactory פושט כדי לחשוף שיטה אחת ליצירת טוקן. הפכנו את AuthTokenFactory מממשק למחלקה מופשטת כדי לאפשר תאימות לאחור ב-Java7. השינוי הזה תואם לדור קודם, אבל השיטות הישנות ליצירת טוקן שירות יחיד הוצאו משימוש, ובסופו של דבר יוסרו.

שינויים בהטמעה

  • הנכסים ממורכזים עכשיו למרכז הסמל, וכך נמנעת הסטת הצל.

  • ‫setState עד JOURNEY_SHARING onStartTripMonitoring() במקום לחכות לסטטוס של הנסיעה במעקב.

  • תמיד מחזירה נתונים לעדכון נתוני הנסיעה הראשון, גם כשנתוני הנסיעה לא מסונכרנים.

  • הוספנו את Android Map Utils כתלות שסופקה.

תיקוני באגים

  • תוקן תחביר ייצוא שגוי של proguard עבור grpc keep.

גרסה 0.7.0 (7 באוגוסט 2019)

תכונות חדשות

  • תמיכה במספר יעדים בשיתוף מסלול להמרת לקוחות.

שינויים ב-API

  • ‫methods חדשים ל-ConsumerTripCallback.

    • onTripIntermediateDestinationsUpdated().
    • onTripETAToNextTripWaypointUpdated().

  • ‫methods חדשים מסוג ConsumerController.

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

  • חדש TripStatuses.

    • TripStatus.ENROUTE_TO_INTERMEDIATE_DESTINATION.
    • TripStatus.ARRIVED_AT_INTERMEDIATE_DESTINATION.

  • פונקציות חדשות לקבלת ערכים (getters) של 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().

תיקוני באגים

  • תוקן באג שגרם לכך שהמסלול לא נחתך למיקום הרכב כשהמעקב אחרי הנסיעה מתחיל באמצע נסיעה פעילה (לא בתחילת המסלול).

  • תוקן באג שבו לא מופעלות קריאות חוזרות (callback) לנסיעה עבור מאזינים שנרשמו ב-Tripmanager אחרי ש-TripManager כבר אחזר נתוני נסיעה.

  • הזום של המצלמה כולל עכשיו רק את המסלול הפעיל ואת נקודת הציון הבאה בנסיעה (נקודת ציון ששייכת לנסיעה). גם אם החלק שנותר גלוי, הזום אף פעם לא יכלול אותו. בעבר, נקודת ההורדה נכללה בהגדלת התצוגה כשהרכב היה בדרך לאיסוף או כשהוא הגיע לנקודת האיסוף. זה כבר לא נכון.

שיפורים

  • מאכלסים את נקודת הדרך הנותרת הראשונה בנתוני הנהג (רשימת נקודות הדרך הנותרות מוחזרת מ-ConsumerTripCallback.onTripRemainingWaypointsUpdated ומ-TripInfo.getRemainingWaypoints()).

  • אם משנים את זמן ההגעה המשוער לציון הדרך הראשון ברשימה, צריך לעדכן את זמן ההגעה המשוער לכל ציוני הדרך שנותרו.

  • הפעלה מחדש של המצלמה האוטומטית רק כשהנהג מגיע לאיסוף. בעבר, המצלמה האוטומטית הייתה מתאפסת למצב מופעל בכל שינוי במצב הנסיעה. המצלמה האוטומטית עדיין מופעלת כברירת מחדל. ההפעלה האוטומטית של המצלמה לא תופעל מחדש אם מוגדרת נסיעה פעילה חדשה בלי הפעלה חדשה של startTripMonitoring().

‫v0.6.1‏ (26 ביוני 2019)

תכונות חדשות

  • תמיכה בשיתוף נסיעות בנסיעות משותפות.

שינויים ב-API

  • הפונקציה ConsumerController.getConsumerMapStyle() מחזירה עכשיו ConsumerMapStyle במקום Task<ConsumerMapStyle>.

  • נוסף PolylineStyle.setZIndex().

תיקוני באגים

  • האנימציה של המסלול מתרחשת עכשיו רק כשהקטע של המסלול מסונכרן, מה שמשפר את חוויית המשתמש.

  • תוקן מצב של 'הבהוב' של הרכב במהלך אינטרפולציה של אנימציה, כשעדכוני המיקום של הנהג קרובים זה לזה.

  • תוקן באג שבו הרכב מתחיל בראש המסלול במקום במיקום המעודכן ביותר שלו, כשהמעקב אחר הנסיעה מתחיל באמצע נסיעה פעילה.

  • הצגת קו הפוליגון של המסלול הפעיל מעל המסלול שנותר כשהם חופפים.

שיפורים

  • עכשיו חושפים את המחלקה Status של gRPC עם methods לא מוצפנים.

גרסה 0.5.1.01 (17 במאי 2019)

תכונות חדשות

  • תמיכה רצופה בשיתוף מסלול להמרת לקוחות.

שינויים ב-API

  • כיתה חדשה 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.