המקטע הזה מכיל נתוני גרסה של Driver SDK ל-Android.
גרסה 5.0.0 (12 בספטמבר 2023)
שינויים בתלות ובהגדרות אישיות
- SDK הניווט עודכן לגרסה 5.x.
- שדרגנו את
minSdkVersion
ל-API 23. - גרסת Kotlin שודרגה ל-1.9.0.
- נוספה תלות ב-Room.
- מעכשיו, באפליקציות שמשתמשות ב-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.
- באפליקציות שמשתמשות ב-Driver SDK חובה להפעיל הסרת סוכרים. לקבלת הוראות, אפשר להיכנס לכתובת https://developer.android.com/studio/write/java8-support#library-desugaring.
תיקוני באגים
- תוקנה הבעיה בהשבתת סנכרוןLocationTracking.
- הושק ממשק DriverStatusListener חדש שמדווח על סיבה בעדכוני הסטטוס של חריגים.
- תוקנה הבעיה לנהגים שנשארים במצב קבוע (החל מגרסה 4.99.0).
גרסה 4.99.0 (9 באוגוסט 2023)
- תמיכה במגוון גרסאות של תלות ב-Nav SDK. ** תומך בגרסה 4.5.0 עד (אבל לא כולל) מגרסה 5.0.0.
- מונע מזמן ההגעה המשוער לרדת באופן עצמאי כשהרכב עומד במקום. אנחנו משיקים את השינוי הזה בהדרגה כניסוי, כך שלא כל האפליקציות יראו את השינוי בו-זמנית.
גרסה 4.5.0 (12 במאי 2023)
- עדכון התלות ב-Navigation SDK לגרסה 4.5. לתשומת ליבך, המזהים של הקבוצה ושל פריטי המידע שנוצרו בתהליך הפיתוח (Artifact) של Navigation SDK השתנו.
גרסה 4.4.3 (20 במרץ 2023)
שינוי בתלות
- התלות ב-Navigation SDK היא גרסה 4.4.1.
גרסה 4.4.2 (15 בפברואר 2023)
תיקוני באגים
משפרים את הזמן לשחזור הרשת כשיש ב-SDK בעיה זמנית בחיבור. התכונה הזו נמצאת כרגע בתהליך השקה כניסוי.
מחיקת
UpdateVehicle
בקשות שמכילות רק את הערך "RAW" המיקום.תיקון מרוץ תהליכים ב'סקירה כללית של המסלול' 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 ו-22.
המשמעות:
- SDK לניווט ו-Driver 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 החל מיוני החל מ-18 באוקטובר 2021 התמיכה ב-21, 2021 ובמכשירי Android 23, 24 ו-25 תקפות.
גרסה 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
בגרסה הזו, ה-SDK של מנהל התקן ל-Android עודכן וכולל את התכונות הבאות שינויים.
שינוי ב-vehicleStops API
VehicleStop
אובייקטים מפנים עכשיו לרשימה של
TaskInfo
אובייקטים במקום רשימה של
Task
אובייקטים. אם אתם צריכים את מצב המשימה,
מומלץ לעקוב אחריו בקוד האפליקציה שלכם.
נוספה כיתה חדשה:
TaskInfo
הפונקציה
getTasks
שלVehicleStop
הוחלפהgetTaskInfoList
מותאמת אישית.הפונקציה
setTasks
שלVehicleStop.Builder
הוחלפהsetTaskInfoList
מותאמת אישית.
מעקב אחר קריסה
הוספנו מעקב ודיווח על קריסות כדי לשפר את היציבות של ה-SDK.
התכונה הזו מופעלת כברירת מחדל, אבל ניתן להשבית אותה אם
setAbnormalTerminationReportingEnabled()
ומעבירים את הערך false
לפני שמאתחלים את ה-SDK.
- הוספת את
setAbnormalTerminationReportingEnabled
לפונקציהDriverApi
.
עצירות ביניים אסינכרוניות
- בוצע שינוי
של
DeliveryVehicleReporter
getRemainingVehicleStops
פונקציה כדי להחזיר פונקציה עתידית<List<VehicleStop>> במקום List> .
אימות
הוסרו מאפיינים מיותרים מהממשק AuthTokenContext
.
האפשרות ServiceType
הוצאה משימוש. עכשיו צריך לקבל רק תלונות על הפרת זכויות יוצרים עבור
לכלול מזהה רכב ומזהה משימה, במקום להסתמך על ServiceType
.
המשתמש
ServiceType
הוסר מ-AuthTokenContext
.המשתמש
getServiceType()
הוסר מ-AuthTokenContext
.המשתמש
setServiceType
הוסר מ-AuthTokenContext.Builder
.
18 באוקטובר 2021 – הקפאת התמיכה ברמות API 23, 24 ו-25
לקריאת ההודעה לתאריך 18 באוקטובר
בתגובה לשינויים ביחסי התלות הפנימיים שלנו, Android API ברמה 23, בגרסאות 24 ו-25 (Android 6, 7.0 ו-7.1) לא תהיה תמיכה בגרסאות חדשות של ערכות ה-SDK לניווט ולמנהל התקן ל-Android, החל ברבעון של 2022.
ערכות SDK של ניווט ונהג לנהג עבור גרסאות Android שיושקו החל מהרבעון השלישי ברבעון של 2022 תהיה תמיכה רק במכשירים שפועלים לפחות Android API ברמה 26.
גרסאות אפליקציה שפותחו עם v4.x או גרסאות קודמות של ערכות ה-SDK לניווט ולמנהל התקן עבור מערכת Android תמשיך לפעול במכשירים עם Android API ברמה 25 ומטה.
גרסה 3.0.4 (28 ביולי 2021)
תכונות
בגרסה הזו, ה-SDK של מנהל התקן זמין באופן רשמי בנפרד מה-SDK לניווט. לצפייה מדריך להעברת נתונים (מיגרציה) לקבלת פרטים.
עדכונים באמצעות API
הוספנו את השיטות הבאות:
DeliveryDriverApi.getDriverSdkVersion()
יציבות ותיקוני באגים
דיווח על PERMISSION_DENIED
שגיאות במקום לסווג אותן בתור
שגיאות חיבור.
הודעה על הוצאה משימוש (21 ביוני 2021)
ההודעה הזו מתארת את ההוצאה משימוש של Driver SDK ל-Android ו-Navigation SDK עבור Android נכון לתאריך שצוין למעלה. ההודעה הזו נשלחה גם כהודעה חיונית בנוגע לשירות (MSA) ללקוחות שיושפעו מהשינוי.
ה-SDK של Nav/Driver ל-Android יהפוך ל-Navigation SDK ל-Android v3.x ו-Driver SDK ל-Android v3.x ל-Android (קבצים בינאריים מפוצלים)
כדי לפשט את שילוב הלקוחות ולהאיץ את היכולת שלנו לספק מודעות אנחנו מפצלים את ה-SDK לניווט ל-Android Driver SDK עבור Android בשני קבצים בינאריים שונים:
- SDK לניווט ל-Android, שיספק ניווט או ניתוב במיוחד לנהגים.
- Driver SDK ל-Android, שיאפשר להשתמש ב-Fleet שירותי אינטרנט עם שמירת מצב במנוע להתקדמות והקצאה של משימות או נסיעות.
לתשומת ליבך, ה-SDK של מנהל ההתקן ל-Android תלוי אך ורק ב- SDK ניווט ל-Android לפונקציות ליבה לניתוב.
מהם השינויים?
השינויים העיקריים בגרסה 3 הם:
- שני קבצים בינאריים במקום אחד.
- הגדרות ברורות יותר של חבילות בשביל Driver SDK למחלקות של Android.
- SDK לניווט ל-Android כולל את ה-SDK של מפות Google ל-Android
כחלק מהאריזה (נכון ל-Navigation SDK ל-Android v2).
- כך התכונות של מפות וניווט יוכלו להתקיים באותה מפה (למשל: שרטוט קווים פוליגוניים ב-NavigationView) וצמצום השימוש בזיכרון מכיוון שנעשה שימוש במפה אחת במקום בשתיים.
- ב-SDK לניווט עבור Android 3.0 אין התאמה מלאה בין התכונות לבין 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. רובם היו איחוד של עותקים כפולים בין ה-API של הניווט ל-Android SDK של מפות ל-Android. כדאי לעיין מדריך להעברת נתונים (מיגרציה) כדי להבין טוב יותר את השינויים האלה.
הוצאה משימוש של Driver SDK ל-Android ו-Navigation SDK ל-Android v1.x
גרסת Nav/Driver SDK v1 הושקה בשנת 2018, ובקרוב גם גרסאות 3 שלנו יהיו זמינות הוא הזמן להוציא משימוש את גרסה 1 כדי להימנע מחוסר הקיימוּת שתומכים בהרבה גרסאות ראשיות.
הזמן שנחסך בכך שאין צורך לתמוך בגרסה הנוספת הזו יאפשר כדי לתמוך טוב יותר בגרסה הראשית האחרונה וליצור עוד תכונות חשובים ללקוחות שלנו.
לכן, גרסת Nav/Driver SDK v1.x הוצאה משימוש ולא תנוהל יותר אחרי 21 ביוני 2022.
כדאי להקדיש רגע כדי לראות את זה איך פועלת ההוצאה משימוש של גרסאות SDK.
סיום התמיכה ב-Android 21 וב-SDK של מנהל התקן Android 21 ו-22
קריאת ההודעה על ביטול
גרסה 4.0 הבאה של SDK לניווט עבור Android ה-SDK של מנהל התקן ל-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 וגם ניווט ב-SDK ל-Android v4.x (מטרגט הרבעון הרביעי של 2021, עשוי להשתנות), ולאחר מכן לא ניתן יהיה להתקין אותו מכשירים עם Android בגרסה 21 ו-22. גרסה 4.x תפעל עם Android 6.0 לפחות (רמת API 23), כך שגרסאות של האפליקציה שלכם שפותחו עם v4.x הקרוב יוכלו של נהגים עם מכשירים עם Android מגרסה 23 ואילך. כדי להדגיש, המשמעות היא שהשינויים הקשורים ל-SDK וכל שינוי באפליקציות שביצעת לא יגיעו לנהגים שיש להם מכשירים עם Android מגרסה 21 ו-22.
הגרסאות של Navigation SDK ל-Android v3 ו- ה-SDK של Drive ל-Android v3 שאליו ברצונך לשדרג בטבלה הבאה נסביר גם מתי הן יהיו זמינות.
אילו תכונות של פלטפורמת מנהלי ההתקנים משמשות אותך? | האם יש לך את היכולות האלה? | אם כן, הגרסאות הראשונות הזמינות שצריך לשדרג אליהן הן... | הזמינות הצפויה (בכפוף לשינויים) |
קישורים להעברה |
---|---|---|---|---|
ניווט בלבד (שיטות הניווט SDK) |
לא | NavSDK גרסה 3.0.1 | עכשיו | מדריך |
כן | NavSDK v3.5 (צפוי) | ספטמבר 2021 | ||
ניווט ומעקב אחר מנוע חיפוש (Fleet Engine) (שיטות NavSDK ו-DriverSDK) | לא | Nav SDK גרסה 3.0 ו-Driver SDK גרסה 3.0 | מדריך להעברת נתונים (מיגרציה) מגרסה 3.0 של מנהל התקן זמין בגרסה | |
כן | NavSDK v3.x ו-DriverSDK גרסה 3.0 |
כדי להמשיך להשתמש בשיטות שהוסרו, ניתן להישאר בגרסה 1.x, אבל בלי צפויה תמיכה או תחזוקה אחרי 21 ביוני 2022 (מידע נוסף מפורט בקטע הבא).
מומלץ לעבור אל v3.x. כלומר:
* המהדורה האחרונה של v1.x תתבצע ברבעון הרביעי של 2021 (ולכן v1 "התכונה 'הוקפאה' לאחר מכן).
* ניתן לתקן את הגרסה האחרונה הזו למשך 6 חודשים לאחר מכן, עד 21 ביוני 2022. אחרי המועד הזה לא נוכל להגיב לבקשות להוספת באג או להוספת תכונות ל-v1.x.
קח רגע כדי לעיין בטבלה הבאה [מדריך להעברת נתונים (מיגרציה)](/maps/resources/navigation-sdk-android/v2/migration) ב- כדי לעזור לכם להתמודד עם השינויים.
מתי אפשר לעשות את זה?
אם כרגע אתם משתמשים ב... | האם יש לך את היכולות האלה? | כדי לשדרג עכשיו | כדי לשדרג בספטמבר 2021 | קישורים להעברה |
---|---|---|---|---|
גרסה 1.x (לא באמצעות FleetEngine.java / פונקציונליות של מנהל התקן) |
לא | NavSDK גרסה 3.0 | מדריך | |
כן | אין אפשרות | NavSDK 3.x | ||
גרסה 1.x (באמצעות FleetEngine.java / פונקציונליות של מנהל התקן) |
לא | אין אפשרות | NavSDK 3.x + DriverSDK 3.x |
המדריך שלמעלה ומדריך להעברת נתונים (מיגרציה) מגרסה 3.0 ואילך זמינים בגרסה. |
כן |
מומלץ להודיע לנהגים עם מכשירים עם Android מגרסה 21 ו-22 כדי לשדרג לגרסה חדשה יותר של Android (מינימום Android 6.0) לשלב את Driver SDK ל-Android ואת ה-Navigation SDK ל-Android. מגרסה v4.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()
, אלא אם המרווח משתנה. - בוצע עדכון של JavaScript ל-method
setReportingInterval()
עם היעד של עידוד קריאה חוזרת ונשנית לשיטה הזו בקצב גבוה לפי המרווחים שבהם נעשה שימוש. - אמינות המיקום של Api 29 שופרה.
v1.13.0
יציבות ותיקוני באגים
- הוספת תלות ב-okhttp שהלקוחות יצטרכו להוסיף לגרסאות build שלהם ב-Gradle.
גרסה 1.11.7 (18 באוקטובר 2019)
יציבות ותיקוני באגים
- עדכוני המיקום נמשכים עכשיו אחרי הפעלה של
onArrival()
עבור יעד נתון. - התראת ברירת המחדל (מחרוזת קבועה במצב Free Nav) תואמת את ערכת צבעים שהוגדרה עבור התראות הניווט. מידע נוסף זמין במאמר הבא: התראות קבועות משותפות.
- טופלה בעיה שבה אירוע מאוחר של עדכון מיקום עלול לגרום עדכון מיקום מזויף, שעלול לגרום לפריטי תוכן כמו קו ישר בתחילת מסלול.
גרסה 1.11.6 (4 באוקטובר 2019)
עדכונים באמצעות API
- נוספה סדרה של שינויים שמבטיחים ש-Driver SDK ימשיך לפעול המיקום מתעדכן במהירות לאחר כשל ברשת. אחרי החיבור לרשת שוחזר, עדכוני מיקום יתחילו שוב במיקום המתוזמן הבא
יציבות ותיקוני באגים
setVehicleState()
חוזר באופן מיידי. עדכון FleetEngine מתבצע עכשיו ברקע של שרשור. טיפול בבעיה של אפליקציה לא מגיבה (ANR).- תוקנה בעיה שגרמה להצגת מסלולי שיתוף נסיעות בתור קו ישר באמצעות גרסאות ישנות יותר של Consumer SDK. מוודא שלא ה-Driver SDK מוסיף למסלול ציוני דרך חד-פעמיים.