נתוני גרסה של Driver SDK ל-Android

הקטע הזה מכיל את נתוני הגרסה של Driver SDK ל-Android.

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

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

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

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

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

גרסה 6.0.0 (25 בנובמבר 2024)

תיקוני באגים

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

עדכוני API

• ממשק StatusListener שהוצא משימוש הוסר.

שינויים בתלות ובתצורה

• מסירים את התלות ב-glide:cronet-integration בקובץ POM.xml
• העדכנו את טווח הגרסאות הנתמכות של Navigation SDK לגרסה 5.x.
• החל מגרסה 6.0.0 של Driver SDK ל-Android, האפליקציות צריכות להתעדכן ל-Kotlin 2.0.
• עכשיו targetSdk היא רמת API 34. זוהי דרישה לכל האפליקציות שיפרסמו בחנות Google Play החל מאוגוסט 2024. עמידה בדרישות של Google Play בנושא רמת ה-API לטרגוט

גרסה 5.99.0 (20 בספטמבר 2024)

תיקוני באגים

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

שינויים בתלות ובתצורה

• מסירים את התלות ב-glide:cronet-integration בקובץ POM.xml

גרסה 5.0.0 (12 בספטמבר 2023)

שינויים בתלות ובתצורה

• עדכנו את Navigation SDK לגרסה 5.x.
• שדרוג minSdkVersion ל-API 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)

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

גרסה 4.4.3 (20 במרץ 2023)

שינוי בתלות

• משדרגים את יחסי התלות של Navigation SDK לגרסה 4.4.1.

גרסה 4.4.2 (15 בפברואר 2023)

תיקוני באגים

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

• ביטול בקשות UpdateVehicle שמכילות רק מיקום 'גולמי'.

• תיקון של מרוץ תהליכים ב-API אלפא של 'סקירה כללית של המסלול'.

גרסה 4.4.1 (18 בנובמבר 2022)

תיקוני באגים

• תוקן באג בלוגיקה של העלאת נתוני תנועה.

שינויים נוספים

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

גרסה 4.4.0 (21 בספטמבר 2022)

תיקוני באגים

• תוקן באג שגרם לכך שלא ניתן היה להסיר את ההתראה 'נהיגה עם מפות Google' אם מכונה של API לא נמחקה.

שינוי בתלות

• משדרגים את יחסי התלות של Navigation SDK לגרסה 4.2.2.

גרסה 4.3.0 (24 באוגוסט 2022)

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

הודעה: השהיית התמיכה ב-Android 5 (21 ביולי 2022)

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

המשמעות:

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

ההודעה הזו מבטלת את ההודעה על השהיית התמיכה בגרסאות Android 21 ו-22 מ-21 ביוני 2021, ואת ההודעה על השהיית התמיכה בגרסאות Android 23,‏ 24 ו-25 מ-18 באוקטובר 2021.

גרסה 4.2.0 (8 ביוני 2022)

שינוי בתלות

• משדרגים את התלות ב-Nav SDK לגרסה 4.1.3.
• הורדת רמת ה-API המינימלית הנתמכת ב-Android ל-21.

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

עדכוני API

• שיניתם את השם של המאפיין parentId של האובייקט Task ל-trackingId. המאפיין הישן עדיין קיים בינתיים, אבל הוא הוצא משימוש.

גרסה 4.0.0 (29 בנובמבר 2021)

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

עדכוני API

במהדורה הזו, Driver SDK ל-Android עודכן עם השינויים הבאים.

שינוי ב-VehicleStops API

אובייקטים מסוג VehicleStop מפנים עכשיו לרשימה של אובייקטים מסוג TaskInfo במקום לרשימה של אובייקטים מסוג Task. אם אתם צריכים את המצב של המשימה, מומלץ לעקוב אחריו בקוד האפליקציה.

• נוספה כיתה חדשה: TaskInfo

• הפונקציה getTasks של VehicleStop הוחלפה בפונקציה getTaskInfoList.

• הפונקציה setTasks של VehicleStop.Builder הוחלפה בפונקציה setTaskInfoList.

מעקב אחר תאונות

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

• הוספת הפונקציה setAbnormalTerminationReportingEnabled ל-DriverApi.

Async getRemainingVehicleStops

• שינינו את הפונקציה getRemainingVehicleStops של DeliveryVehicleReporter כך שתחזיר את הערך Future<List<VehicleStop>> במקום List<VehicleStop>.

אימות

הוסרו מאפיינים לא נחוצים מהממשק של AuthTokenContext. האפשרות ServiceType הוצאה משימוש. מעכשיו, צריך לקבל תלונות רק על מזהה הרכב ומזהה המשימה שכלולים, במקום להסתמך על ServiceType.

• הסרנו את ServiceType מ-AuthTokenContext.

• הסרנו את getServiceType() מ-AuthTokenContext.

• הסרנו את setServiceType מ-AuthTokenContext.Builder.

18 באוקטובר 2021 – הקפאת התמיכה ברמות API 23,‏ 24 ו-25

גרסה 3.0.4 (28 ביולי 2021)

תכונות

במהדורה הזו, Driver SDK מופרד באופן רשמי מ-Navigation SDK. פרטים נוספים זמינים במדריך להעברת נתונים.

עדכוני API

נוספו השיטות הבאות:

‏'RidesharingDriverApi.getDriverSdkVersion()‎'

יציבות ותיקוני באגים

דיווח על שגיאות מסוג PERMISSION_DENIED במקום לסווגם כשגיאות חיבור.

הודעה על הוצאה משימוש (21 ביוני 2021)

בהודעה הזו מתוארות ההוצאות משימוש של Driver SDK ל-Android ושל Navigation SDK ל-Android החל מהתאריך שצוין למעלה. ההודעה הזו נשלחה גם ללקוחות הרלוונטיים כהודעה חובה בנוגע לשירות (MSA).

Nav/Driver SDK ל-Android יהפוך ל-Navigation SDK ל-Android v3.x ול-Driver SDK ל-Android v3.x ל-Android (קובצי בינארי מפוצלים)

כדי לפשט את השילוב של הלקוחות ולהאיץ את היכולת שלנו לספק תכונות מועילות, אנחנו מפצלים את Navigation SDK ל-Android ואת Driver SDK ל-Android לשני קבצים בינאריים שונים:

• Navigation SDK ל-Android, שיספק פונקציונליות של ניווט/ניתוב לנהגים.
• Driver SDK ל-Android, שמאפשר לכם להשתמש בשירותי האינטרנט של Fleet Engine עם שמירת מצב (stateful) כדי לקבל מידע על ההתקדמות של נסיעות או משימות ולבצע הקצאה שלהן.

חשוב לזכור של-Driver SDK ל-Android יש תלות חיונית ב-Navigation SDK ל-Android לצורך פונקציות ניתוב ליבה.

מהם השינויים?

השינויים העיקריים בגרסה 3 הם:

• שני קובצי בינארי במקום אחד.
• הגדרות ברורות יותר של חבילות לכיתות של Driver SDK ל-Android.
• ‫Navigation SDK ל-Android כולל את SDK של מפות ל-Android כחלק מחבילת ה-SDK (החל מ-Navigation SDK ל-Android v2).
  • כך אפשר להציג מפות ותכונות ניווט באותה מפה (למשל, ציור קווים פוליגונים ב-NavigationView), וגם לצמצם את השימוש בזיכרון כי נעשה שימוש במפה אחת במקום בשתי מפות.
  • ב-Navigation SDK ל-Android 3.0 אין שוויון מלא בתכונות ל-Navigation 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. רוב השינויים האלה היו מיזוגים של כיתות כפולות בין Navigation SDK ל-Android לבין SDK של מפות ל-Android. מומלץ לעיין במדריך ההעברה כדי להבין טוב יותר את השינויים האלה.

הוצאה משימוש של Driver SDK ל-Android ו-Navigation SDK ל-Android בגרסה 1.x

גרסת v1 של Nav/Driver SDK שוחררה ב-2018, ובקרוב נשיק את הגרסאות שלנו בגרסה 3. לכן, הגיע הזמן להוציא משימוש את הגרסה 1 כדי להימנע מהתמיכה הבלתי קיימא במספר גרסאות ראשיות.

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

לכן, Nav/Driver SDK v1.x הוצא משימוש והתמיכה בו תופסק אחרי 21 ביוני 2022.

כדאי להקדיש כמה רגעים כדי לקרוא על אופן ההוצאה משימוש של גרסאות SDK.

סיום התמיכה ב-Navigation SDK וב-Driver SDK בגרסאות Android 21 ו-22

גרסה 1.15.3 (9 באוקטובר 2020)

עדכוני API

• 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.
• תוקן באג שגרם לכך שלא יתבצעו שמות של נקודות דרך לפי קואורדינטות (lat/lng) כשהמרת קואורדינטות לכתובות (reverse geocoding) בצד השרת נכשלת.

גרסה 1.14.2 (2 בפברואר 2019)

תכונות

• מונע מ-DriverSDK לשלוח מיקומים של 0,0 ל-Fleet Engine (שיפור של שיתוף המסלולים והקלט של מיקומי ההקצאה).
• רישום נוסף ביומן כדי לשפר בעיות של מיקום תקוע ולצמצם את האפשרויות החלופיות לשיתוף המסלול.
• התעלמות מבקשות חוזרות ל-setLocationReportingInterval(), אלא אם מרווח הזמן משתנה.
• עדכנו את ה-javadocs של השיטה setReportingInterval() במטרה למנוע קריאות חוזרות של השיטה הזו בקצב גבוה ביחס למרווחי הזמן שבהם נעשה שימוש.
• אמינות המיקום של API 29 השתפרה.

v1.13.0

יציבות ותיקוני באגים

• הוספת תלות ב-okhttp שהלקוחות יצטרכו להוסיף ל-builds שלהם ב-Gradle.

גרסה 1.11.7 (18 באוקטובר 2019)

יציבות ותיקוני באגים

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

גרסה 1.11.6 (4 באוקטובר 2019)

עדכוני API

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

יציבות ותיקוני באגים

• הפונקציה setVehicleState() מחזירה תשובה באופן מיידי. העדכון של FleetEngine מתבצע עכשיו בשרשור ברקע. פתרון לבעיה מסוג 'האפליקציה לא מגיבה' (ANR).
• תוקנה בעיה שגרמה לנתיבי שיתוף המסלול להופיע כקו ישר בגרסאות ישנות יותר של Consumer SDK. מוודא ש-Driver SDK לא מוסיף למסלול נקודות דרך חד-פעמיות.