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

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

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

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

  • SDK לניווט עודכן לגרסה v5.x.
  • בוצע שדרוג של minSdkVersion ל-API 23.
  • גרסת Kotlin שודרגה ל-1.9.0.
  • נוספה תלות בחדר.
  • מעכשיו, באפליקציות שנעשה בהן שימוש ב-Driver SDK צריך להיות API מגרסה 31 ואילך של targetSdkVersion.
  • באפליקציות שנעשה בהן שימוש ב-Driver SDK חייבים להפעיל עכשיו תמיכה בספריית Java 8. הוראות לעדכון מפורטות בכתובת https://developer.android.com/studio/write/java8-support.
  • אפליקציות שמשתמשות ב-ProGuard או ב-DexGuard חייבות לעבור ל-R8. מידע נוסף זמין בכתובת https://developer.android.com/build/shrink-code.
  • באפליקציות שנעשה בהן שימוש ב-SDK של מנהל התקן צריך להפעיל את תהליך ההסרה. הוראות זמינות בכתובת https://developer.android.com/studio/write/java8-support#library-desugaring.

תיקוני באגים

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

גרסה 4.99.0 (9 באוגוסט 2023)

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

גרסה 4.5.0 (12 במאי 2023)

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

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

שינוי בתלות

  • שדרוג התלות של ה-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 לא נוקה.

שינוי בתלות

  • שדרוג התלות של ה-SDK של הניווט לגרסה 4.2.2.

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

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

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

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

המשמעות:

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

ההודעה הזו מבטלת את ההודעה על קפיאה של התמיכה בגרסאות 21 ו-22 של Android מ-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. הנכס הישן עדיין קיים אבל הוצא משימוש.

  • חלק מסוגי ההחזרות השתנו מ-Future ל-ListenableFuture הספציפי יותר, ומ-List ל-ImmutableList הספציפי יותר.

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

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

עדכונים בממשק API

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

שינוי ב-API של AutomotiveStops

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

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

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

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

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

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

אסינכרוני get yetVehicleStops

אימות

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

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

לקריאת ההודעה מ-18 באוקטובר

בעקבות שינויים בתלות הפנימית שלנו, החל מהרבעון השלישי של ערכות ה-SDK לניווט ו-Drive ל-Android לא תהיה תמיכה בגרסאות 23, 24 ו-25 של Android API (בגרסאות 6, 7.0 ו-7.1).

ערכות SDK לניווט ולנהגים עם גרסאות Android שפורסמו החל מהרבעון השלישי של שנת 2022 יתמכו רק במכשירים עם Android API ברמה 26 לפחות.

גרסאות של אפליקציות שנבנו עם v4.x או גרסאות קודמות של ה-SDK של הניווט ו-Driver ל-Android ימשיכו לפעול במכשירים עם Android API ברמה 25 ומטה.

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

מאפיינים

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

עדכונים בממשק API

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

DeliveryDriverApi.getDriverSdkVersion()

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

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

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

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

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

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

חשוב לשים לב של-Drive SDK for Android יש תלות נדרשת ב-Navigation SDK ל-Android לפונקציות הליבה של הניתוב.

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

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

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

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

  • השיטות הבאות של Nav/Driver SDK הוצאו משימוש בגרסה 1.16, שהושקה ב-10 באוגוסט 2020, והוסרו בגרסה 3.0:
    • Waypoint#fromLatLng(*)
    • Waypoint#fromPlaceId(*)
    • Navigator#startGuidance(resumeIntent)
    • NavigationApi#initForegroundServiceManager(*)
  • לשם השלמות והבהירות, שימו לב שהוסרנו מספר שיטות במעבר מ-v1 ל-v2. רוב הגורמים האלה היו איחוד של מחלקות כפולות בין Navigation SDK ל-Android לבין ה-SDK של מפות Google ל-Android. מומלץ לעיין במדריך להעברת נתונים (מיגרציה) כדי להבין טוב יותר את השינויים האלה.

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

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

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

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

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

קריאת ההודעה שבוטלה

הגרסה החדשה 4.0 של Navigation SDK ל-Android וה-SDK של Driver ל-Android תתמוך בגרסה מינימלית של [Android 6.0 (רמת API 23)](https://developer.android.com/studio/releases/platforms#6.0){: .external}. הגרסה המינימלית הנתמכת הנוכחית היא Android 5.0 (רמת API 21). אנחנו צופים שגרסה 4.0 תפורסם ברבעון הרביעי של 2021. מה זה אומר?

  • גרסאות של אפליקציות שנוצרו בגרסאות מוקדמות יותר מ-v4.x ימשיכו לפעול במכשירי Android 21 ו-22. אפליקציות של מנהלי התקנים ששילבו את ערכות ה-SDK הנוכחיות שלנו ימשיכו לפעול במכשירים עם Android מגרסה 21 ואילך. זה כמו קודם.
  • גרסאות אפליקציה שפותחו באמצעות Driver SDK ל-Android ו-Navigation SDK ל-Android v4.x (שמיועדות לרבעון הרביעי של שנת 2021, עשויות להשתנות) ולאחר מכן לא תהיה אפשרות להתקין אותן במכשירים עם Android מגרסה 21 ו-22. v4.x תרוץ ב-Android 6.0 (רמת API 23) מינימלית. לכן, גרסאות של האפליקציה שפותחו עם מנהלי התקנים מגרסה 2+ שיש להן גרסה 3 עם מנהלי התקנים נוספים שיש ל-Android ול-Android v4.x

בטבלה הבאה מוסבר מתי הן יהיו זמינות, לצד הגרסאות של Navigation SDK ל-Android v3 ושל Driver SDK ל-Android v3 שאליהן רוצים לשדרג.

מהן התכונות של פלטפורמת ה-Drive שלך? האם היכולות האלה משמשות אותך? לאחר מכן, הגרסאות הראשונות שזמינות כי עליך לשדרג אליהן הן... זמינות צפויה
(בכפוף לשינויים)		 קישורים להעברה
ניווט בלבד
(שיטות שלNavSDK)		 לא NavSDK גרסה 3.0.1 עכשיו מדריך
כן NavSDK v3.5 (צפוי) ספטמבר 2021
מעקב אחר ניווט ו-Flet Engine (שיטות של NavSDK ו-DriverSDK) לא Navr SDK v3.0 ו-Driver SDK v3.0 מדריך להעברת נתונים (מיגרציה) של מנהל התקן בגרסה 3.0 זמין בגרסה העדכנית
כן NavSDK v3.x ו-DriverSDK v3.0

כדי להמשיך להשתמש בשיטות שהוסרו, אפשר להמשיך להשתמש בגרסה v1.x, אבל בלי לצפות לתמיכה או לתחזוקה אחרי 21 ביוני 2022 (מידע נוסף מפורט בקטע הבא).

מומלץ לעבור לגרסה v3.x. מה זה אומר?

* הגרסה האחרונה של v1.x תתבצע ברבעון הרביעי של 2021 (ולכן הגרסה v1 תהיה 'feature שהוקפא' מאותה תקופה).

* אפשר לתקן את הגרסה האחרונה הזו למשך 6 חודשים לאחר מכן, עד 21 ביוני 2022. לאחר המועד הזה, לא נוכל להגיב לבקשות לבאגים או לתכונות לגרסה v1.x.

מומלץ להקדיש כמה דקות כדי לעיין בטבלה הבאה וב[מדריך ההעברה](/maps/document/navigation-sdk-android/v2/migration) כדי לעזור לכם להתנהל בנוגע לשינויים האלה.

מתי אפשר לעשות את זה?

אם אתם נמצאים כרגע ב... האם היכולות האלה משמשות אותך? כדי לשדרג עכשיו לשדרוג בספטמבר 2021 קישורים להעברה
v1.x
(לא באמצעות FleetEngine.Java / פונקציונליות של Drive) 		לא NavSDK גרסה 3.0 מדריך
כן אין אפשרות NavSDK 3.x
v1.x
(שימוש בפונקציונליות של FleetEngine.Java / מנהל התקן)		 לא אין אפשרות NavSDK 3.x +
DriverSDK 3.x		 המדריך שלמעלה וגם מדריך להעברת נתונים (מיגרציה) של Driver גרסה 3.0, שזמין בגרסה העדכנית.
כן

אנחנו ממליצים להודיע לנהגים שיש להם מכשירים עם Android 21 ו-22 לשדרג לגרסה חדשה יותר של Android (גרסה 6.0 לפחות) של Android לפני שילוב של Driver SDK ל-Android ו-Navigation SDK ל-Android מגרסה 4.x ואילך באפליקציה לנהגים.

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

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

מאפיינים

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

v1.13.0

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

  • מוסיף תלות ב-okhttp שהלקוחות יצטרכו להוסיף לגרסאות ה-build שלהם.

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

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

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

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

עדכונים בממשק API

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

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

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