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

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

גרסה 7.0.0 (5 בדצמבר 2025)

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

• שודרג מ-minSdkVersion ל-API 26.

• שודרג מ-targetSdkVersion ל-API 36.

• עדכנו את Navigation SDK כך שיכלול גרסאות בטווח, כולל גרסה 7.0.0 ומעלה.

גרסה 6.99.0 (5 בדצמבר 2025)

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

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

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

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

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

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

גרסה 6.2.0 ‏ (18 ביוני 2025)

תיקוני באגים

• תוקנה הקריסה של NullPointerException במהלך התקשרות אל DriverApi.createInstance() כשלא סופק DriverStatusListener.

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

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

• עדכנו את Navigation SDK כך שיכלול גרסאות נתמכות בטווח, כולל גרסה 6.1.0 ומעלה.

גרסה 6.1.0‏ (10 במרץ 2025)

תיקוני באגים

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

גרסה 5.99.1 (10 בינואר 2025)

תיקוני באגים

• תוקנה בעיה שבה נהגים קיבלו שגיאות gRPC עם הקוד INTERNAL וההודעה Panic! תיאור של באג!" בהפעלה הראשונה של האפליקציה אחרי ההתקנה.

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

תיקוני באגים

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

עדכוני API

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

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

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

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

תיקוני באגים

• תוקנה בעיה בסנכרון של disableLocationTracking.
• הוספנו את הממשק החדש DriverStatusListener שמדווח על סיבה בעדכוני סטטוס של חריגים.
• תוקנה בעיה שגרמה לנהגים להישאר במקום (זמין החל מגרסה 4.99.0).

גרסה v4.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, נתמוך רק ברמות API‏ 23 ומעלה ב-Android. במילים אחרות, אחרי התאריך הזה נפסיק את התמיכה ברמות API‏ 21 ו-22 ב-Android בכל גרסאות ה-SDK. המשמעות היא שלא נתקן באגים שקשורים ל-Android 21 או ל-Android 22 בכל גרסה של SDK (כולל גרסה 4.x), ואין לנו אפשרות להבטיח שערכות ה-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

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

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

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

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

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

Async getRemainingVehicleStops

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

אימות

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

• הסרנו את ServiceType מהקבוצה AuthTokenContext.

• הסרנו את getServiceType() מהקבוצה AuthTokenContext.

• הסרנו את setServiceType מהקבוצה AuthTokenContext.Builder.

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

‫v3.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 עם שמירת מצב כדי לעקוב אחרי התקדמות הנסיעה או המשימה והקצאה.

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

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

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

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

הוצאה משימוש של Driver SDK ל-Android ו-Navigation SDK ל-Android v1.x

גרסה 1 של 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.

גרסה v1.15.1‏ (12 במאי 2020)

תכונות

ניתוח ראשוני של נתונים מגרסה 1.15.0 הצביע על שיפורים משמעותיים בדיווח על מיקומים יציבים (צמצום המקרים של מיקומים 'תקועים'). תיקון הפאצ' הזה מאפשר להמשיך להשתמש בדוחות המיקום המשופרים. בעיית ה-ANR לא הייתה קשורה לשיפורים האלה.

שיפורים ביציבות ותיקוני באגים

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

‫v1.15.0 (23 במרץ 2019)

תכונות

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

שיפורים ביציבות ותיקוני באגים

• הגדלנו את minSdkVersion ל-navsdk ל-19.
• תוקן באג שגרם לכך ששמות של נקודות ציון של קווי רוחב/אורך לא נשמרו כשפעולת המרת הקואורדינטות לכתובות (reverse geocoding) בצד השרת נכשלה.

גרסה v1.14.2 (2 בפברואר 2019)

תכונות

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

v1.13.0

שיפורים ביציבות ותיקוני באגים

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

‫v1.11.7 (18 באוקטובר 2019)

שיפורים ביציבות ותיקוני באגים

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

‫v1.11.6 (4 באוקטובר 2019)

עדכוני API

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

שיפורים ביציבות ותיקוני באגים

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