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

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

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

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

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

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

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

גרסה v6.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! תיאור השגיאה "This is a bug!" בהשקה הראשונה של האפליקציה אחרי ההתקנה.

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

• תוקנה בעיית מרוץ תהליכים ב-ALPHA 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 או 22 בכל גרסה של SDK (כולל גרסה 4.x), ואין לנו אפשרות להבטיח שערכות ה-SDK יפעלו בצורה תקינה.

ההודעה הזו מבטלת את ההודעה על הקפאת התמיכה ב-Android 21 ו-Android 22 מ-21 ביוני 2021, ואת ההודעה על הקפאת התמיכה ב-Android 23,‏ Android 24 ו-Android 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

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

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

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

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

• שני קבצים בינאריים במקום אחד.
• הגדרות חבילה ברורות יותר עבור מחלקות Driver SDK ל-Android.
• ‫Navigation SDK ל-Android כולל את SDK של מפות ל-Android כחלק מהחבילה (החל מגרסה 2 של Navigation SDK ל-Android).
  • השימוש ב-MapFragment מאפשר לתכונות של מפות וניווט להתקיים יחד באותה מפה (למשל, ציור קווים שבורים ב-NavigationView), ומצמצם את השימוש בזיכרון כי נעשה שימוש במפה אחת במקום בשתיים.
  • ‫Navigation SDK ל-Android 3.0 לא כולל את כל התכונות שקיימות ב-Navigation SDK ל-Android, אבל בגרסה 3.2 רוב הבעיות האלה ייפתרו. פרטים נוספים מופיעים בקטע מה אפשר לעשות ומתי?
• רישום ביומן שיעזור לנו לנפות באגים בבעיות שאתם עלולים להיתקל בהן.

בנוסף, הוסרו בגרסה 3 ה-methods הבאות, שסומנו בעבר כפריטים שהוצאו משימוש וקיים להם פתרון חלופי:

• השיטות הבאות של 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

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

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

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

מומלץ להקדיש רגע כדי להבין איך הוצאה משימוש של גרסאות SDK עובדת.

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

גרסה v1.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 פעלה במשך שמונה שעות ללא 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 מוודא שלא מתווספות למסלול נקודות ציון חד-פעמיות.