אפליקציה לרכב

פיתוח אפליקציות לפי תבניות ל-Android Auto ול-Android Automotive OS.
העדכון האחרון גרסה יציבה מועמד לגרסה גרסת בטא גרסה אלפא
18 בספטמבר 2024 1.4.0 - בטא 02.01.7 -

הצהרה על יחסי תלות

כדי להוסיף יחסי תלות ל-Car App Library, צריך להוסיף את המאגר של Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    implementation "androidx.car.app:app:1.4.0"

    // For Android Auto specific functionality
    implementation "androidx.car.app:app-projected:1.4.0"

    // For Android Automotive specific functionality
    implementation "androidx.car.app:app-automotive:1.4.0"

    // For testing
    testImplementation "androidx.car.app:app-testing:1.4.0"
}

Kotlin

dependencies {
    implementation("androidx.car.app:app:1.4.0")

    // For Android Auto specific functionality
    implementation("androidx.car.app:app-projected:1.4.0")

    // For Android Automotive specific functionality
    implementation("androidx.car.app:app-automotive:1.4.0")

    // For testing
    testImplementation("androidx.car.app:app-testing:1.4.0")
}

למידע נוסף על יחסי תלות, אפשר לעיין במאמר הוספת יחסי תלות של build.

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במשאבי העזרה בנושא מעקב אחר בעיות.

גרסה 1.7

גרסה 1.7.0-beta02

18 בספטמבר 2024

androidx.car.app:app-*:1.7.0-beta02 משוחרר. גרסה 1.7.0-beta02 כוללת את ההתחייבויות האלה.

שינויים ב-API

  • הוספת KEY_ROOT_HINT_MEDIA_HOST_VERSION נוסף (I8796b)
  • מחליפים את הכיתה TabContents.Api8Builder ב-constructor של @ExperimentalCarApi בכיתה TabContents.Builder (I26fbe)
  • הוספת פעולת Intent ואקסטרות ל-CarMediaApp (I50782)
  • סימון ממשקי ה-API להעברת הודעות כממשקי API לא ניסיוניים (I0b070)
  • הוספת טעינה מרחוק של פריטים ל-SectionedItemTemplate (מאפשרת לטעון רשימות ארוכות בלי קריסה) (I0d122)
  • הוספת SectionedItemTemplate לרשימת התבניות הנתמכות ב-TabTemplate ב-API 8. (Idc5d6)

תיקוני באגים

  • הסרנו את התיאור הידני של הגישה לממשקי API חדשים של פלטפורמות, כי זה קורה באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, R8 גרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל, D8 גרסה 8.1). ללקוחות שלא משתמשים ב-AGP מומלץ לעדכן לגרסה D8 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (I9496c, ‏ b/345472586)

גרסה 1.7.0-beta01

26 ביוני 2024

androidx.car.app:app-*:1.7.0-beta01 משוחרר. גרסת 1.7.0-beta01 כוללת את ההוספות האלה. התכונות הן אותן תכונות שפורסמו ב-alpha01, ואלה הן:

תכונות חדשות

  • מפה עם תוכן: תבנית חדשה של מפה על קנבס בתוספת תבנית תוכן, שכרגע יכולה להיות רשימה, רשת, חלונית או הודעה.
    • התכונות RoutePreview, PlaceListNavigation וגם MapTemplate הוצאו משימוש. התבניות ימשיכו לפעול כפי שהן.
    • אפליקציות לדוגמה עודכנו כך שיוצגו בהן MapWithContent במקום תבניות שכבר לא נתמכות
  • פריט שיחה: ממשקי API חדשים להצגת שיחות (IM, SMS) והקראה של Assistant ברכב.
  • מידות הרכב: API חדש לאחזור מדדים של הרכב (נתונים ב-AAOS כרגע).

שינויים ב-API

  • מוסיפים את התג @ExperimentalCarApi ל-MediaPlaybackTemplate.Builder. (Ic1957)
  • הוספת SectionedItemTemplate חדש בניסוי. (I5958a)
  • הצגה של CarAppApiLevel 8 (I3fa22)
  • הוספת MediaPlaybackTemplate להצגת תוכן במהלך הפעלת מדיה בספריית האפליקציות ברכב. (I3c10d)
  • נוספה ממשק API חדש לאפליקציות כדי לזהות אם המערכת תומכת באודיו ברקע בזמן נהיגה (I0f868)

תיקוני באגים

  • תיקון מקרים מסוימים של דליפות זיכרון וקריסות בקוד הלקוח של CAL ובאפליקציית הדוגמה לניווט ב-CAL. (I55e04)
  • כדי למנוע קריסות, מחליפים את requireNotNull instances ב-method onDestroy של BaseCarAppActivity בבדיקות מסוג if-null. (Iec676)

גרסה 1.7.0-alpha02

17 באפריל 2024

androidx.car.app:app-*:1.7.0-alpha02 משוחרר. הגרסה 1.7.0-alpha02 מכילה את ההוספות האלה.

תכונות חדשות

  • נוספו דגלים לא תקפים לתבניות שמבוססות על מפה, שתתבנית MapWithContent תפעל בהמשך.

שינויים ב-API

  • הוצאה משימוש של MapTemplate,‏ RoutePreviewNavigationTemplate ו-PlaceListNavigationTemplate הישנים ועידוד השימוש ב-MapWithContentTemplate החדש (Ib0a08)

גרסה 1.7.0-alpha01

3 באפריל 2024

androidx.car.app:app-*:1.7.0-alpha01 משוחרר. שינינו את הסכימה של ניהול הגרסאות של הספרייה כך שתתאים לגרסה הפעילה של CarApi. המטרה היא להפחית את הסיכוי לבלבול בנושא סכימת השמות שמבוססת על משוב של המפתחים. כתוצאה מכך, נדלג על הגרסאות 1.5 ו-1.6 ונעבור ישירות לגרסה 1.7. גרסת 1.7.0-alpha01 מכילה את ההתחייבויות האלה.

תכונות חדשות

  • מפה עם תוכן: תבנית חדשה בשם MapWithContent שתומכת בתוכן מסוג רשימה, רשת, חלונית או הודעה בתוך מפה.
    • RoutePreview, PlaceListNavigation, תבניות המפה הוצאו משימוש.
    • אפליקציות לדוגמה עודכנו כדי להציג את הפונקציונליות של תבניות שהוצאו משימוש באמצעות MapWithContent.
  • Conversation Item: ממשקי API חדשים להצגת שיחות (צ'אט, SMS) והקראה של Assistant ברכב.
  • מאפייני רכב: ממשק API חדש לאחזור מידות של כלי רכב (הנתונים נמצאים כרגע ב-AAOS).

שינויים ב-API

  • סימון סוג התמונה של שורה קטנה במיוחד כניסיוני (I5184b)
  • נוספה ממשק API מסוג CarInfo#fetchExteriorDimensions שמאפשר גישה למידע על המימדים החיצוניים של הרכב, כמו גובה, רוחב וכו' (Ia40c5)
  • הוסר התג ExperimentalAPI מ-MapWithContentTemplate (I66db8)
  • מעדכנים את הפרמטר GridItem#setTitle כך שיהיה nullable. (I3d610)
  • ממשק ה-API של GetHeader לא מחייב API 7 כי הוא תואם לאחור (I8c812)
  • הוספת תמיכה ב-Header ב-ListTemplate, הוצאה משימוש של headerAction,‏ headerTitle ו-actionStrip (I7ae01)
  • הוצאה משימוש של title,‏ headerAction ו-actionStrip ב-GridTemplate והוספת תמיכה ב-Header (I41a9c)
  • הסרת הדרישה ברמה 7 לממשקי API ניסיוניים: תג, GridTemplate פונקציות קבלה/הגדרה של גודל הפריט וצורת התמונה, GridItem שיטות לקבלה/הגדרה של תג. (Id71eb)
  • הוצאה משימוש של title,‏ headerAction ו-actionStrip ב-PaneTemplate, הוספת תמיכה חדשה ב-Header (I23154)
  • שינינו את הטלמטריה של Media Center מ-BroadcastReceiver ל'פעולת גלישה בהתאמה אישית'. (I4185f)
  • נוספה תמיכה במאפיין Header ב-MessageTemplate. תמיכה שהופסקה ב-ActionStrip, ב-headerAction וב-title. (Ie2de8)
  • שינוי החשיפה של קבוע התראות (Icf8a8)
  • מסירים את המאפיין isLoading מתבנית ההורה (I651e6)
  • הוספת פריטים נוספים כדי להודיע לאפליקציות מדיה על הפרמטרים העיקריים של ממשק המשתמש (I85ca2)
  • הוספת תכונה של Media Center analytics ל-MediaExtensions (I7ce28)
  • נוספה אפשרות לתמונה קטנה במיוחד בשורות. (I72c03)

תיקוני באגים

  • מעדכנים את Javadoc בתאריך ConversationItem כדי לציין שיש למיין את ההודעות מהישן לחדש ביותר. (I77a2a)
  • עדכון הלוגיקה של חיתוך ListTemplate כדי להסיר את ההודעות הישנות ביותר מ-ConversationItem (Ie0a61)

גרסה 1.4

גרסה 1.4.0

29 במאי 2024

androidx.car.app:app-*:1.4.0 משוחרר. גרסה 1.4.0 היא שדרוג של 1.4.0-rc02.

שינויים חשובים מאז גרסה 1.3.0

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

גרסה 1.4.0-rc02

13 בדצמבר 2023

androidx.car.app:app-*:1.4.0-rc02 משוחרר. גרסה 1.4.0-rc02 מכילה את ההצהרות האלה. תיקונים קלים בלבד

תיקוני באגים

  • מעדכנים את Javadoc ב-ConversationItem כדי לציין שצריך למיין את ההודעות מהישן לחדש (I77a2a)
  • עדכון הלוגיקה של חיתוך ListTemplate כדי להסיר את ההודעות הישנות ביותר מ-ConversationItem (Ie0a61)

גרסה 1.4.0-rc01

1 בנובמבר 2023

ההשקה של androidx.car.app:app-*:1.4.0-rc01 ללא שינויים משמעותיים. גרסה 1.4.0-rc01 מכילה את ההצהרות האלה.

גרסה 1.4.0-beta02

20 בספטמבר 2023

androidx.car.app:app-*:1.4.0-beta02 משוחרר. גרסה 1.4.0-beta02 מכילה את ההצהרות האלה. הגרסה הזו כמעט זהה ל-beta01, אבל הדרישה ל-compileSdk קטנה ל-33.

תיקוני באגים

  • תוקן באג שגרם לכך שמסכי טעינה בכרטיסיות לא יוצגו כראוי. (cae860)

גרסה 1.4.0-beta01

9 באוגוסט 2023

androidx.car.app:app-*:1.4.0-beta01 משוחרר. גרסה 1.4.0-beta01 מכילה את ההצהרות האלה.

הערה: הגרסה 1.4-beta01 דורשת את compileSdk34, שעדיין נמצא בסטטוס פיתוח. הבעיה תיפתר בגרסה 1.4-beta02. לחלופין, אפשר להוסיף את android.suppressUnsupportedCompileSdk=34 לקובץ settings.gradle של הפרויקט כדי לדכא את האזהרה באופן זמני ובטוח.

תכונות חדשות

שינויים ב-API

  • ראו alpha02

גרסה 1.4.0-alpha02

26 ביולי 2023

androidx.car.app:app-*:1.4.0-alpha02 משוחרר. גרסה 1.4.0-alpha02 מכילה את ההצהרות האלה.

  • השקת Alpha02 נועדה להכין את הקרקע להשקת beta01 בקרוב.

תכונות חדשות

  • רינדור מפה בתמיכה באשכול כלים לאפליקציות ניווט
  • הוספנו כרטיסיות לאפליקציות כדי לשפר את חוויית השימוש בפריסת האפליקציות
  • נוספו אפשרויות רינדור של תבנית רשימה או תבנית רשת
  • נוספו קטגוריות חדשות של מזג אוויר ושל תקשורת
  • העברת כמה ממשקי API למהדורה הבאה של CarApi 7

שינויים ב-API

  • הוספת שדות מולטימדיה ל-CarMessage (I5aaf6)
  • הוספה של פעולות מותאמות אישית לקמפיין ConversationItem בספריית האפליקציות של הרכב (Ie5ed6)
  • מוסיפים תכנים נוספים כדי לציין שפריט מדיה מסוים מופעל בפורמט אודיו אימרסיבי, ומציגים את הלוגו של פורמט התוכן שלו (Icb5bb)
  • הוספת סוג פעולה חדש, ActionsConstraints API לתמיכה בלחצן הכתיבה. (I31661)
  • נוצרה בתור set/getTemplate בתור set/get ContentTemplate (Ica036)
  • עכשיו פרמטר התבנית יהיה @NonNull. מסמכי API מעודכנים של MapWithContentTemplate (I0f8ed)
  • הסרת התג @ExperimentalCarApi עבור פעולות ב-ListTemplate להשקה ב-CAL 1.4 (I2cfcb)
  • הסרת התג @ExperimentalCarApi עבור TabTemplate (Ifcb82)
  • הסרת @ExperimentalCarApi הערות מהפעולות המשניות והקישוטים בשורה (I8487e)
  • הוספת מזהה תוכן של כרטיסייה פעילה אל TabTemplate והוצאה משימוש של המצב הפעיל בכרטיסיות (I96932)
  • הוספת הנכס ItemImageShape אל GridTemplate (Ibf431)
  • מוסיפים את המאפיין ItemSize ל-GridTemplate, שמגדיר את הגודל של הפריטים ברשימה לפי קטגוריות יחסיות של קטנות, בינוניות וגדולות. (Icdb3b)
  • פותחים את הגישה ל-API למפתחים כדי לקבל עותק של מקבץ המסכים הנוכחי. (I48107)
  • נוספה קטגוריה של אפליקציות מזג אוויר לספריית האפליקציות של הרכב (I2be44)
  • הוספת קטגוריה לאפליקציות לשיחות לספריית האפליקציות ברכב (Icab33)
  • הטקסט GridItem.Builder#setBadge() הוחלף בשיטות setImage() עם עומס יתר (Id2000)
  • הוספת מאפיין סמל לתג (I629b2)
  • הוספת שיטה להגדרת צבע הרקע של תג הנקודות (I6411c)
  • הוספת המאפיין Badge אל GridItem, כדי לאפשר הצגת תג מעל תמונה של GridItem. (I95de7)
  • נוספו אובייקטים ניסיוניים של תגים שמייצגים תגים שמוצגים מעל תמונה. (I9878d)

גרסה 1.4.0-alpha01

22 בפברואר 2023

androidx.car.app:app-*:1.4.0-alpha01 משוחרר. גרסה 1.4.0-alpha01 מכילה את התחייבויות אלה.

שינויים ב-API

  • הוספת פעולות ברמה העליונה ל-GridTemplate בספריית האפליקציות לרכב (Id0191)
  • הוספה של פעולות ברמה העליונה אל ListTemplate בספריית האפליקציות של הרכב (I9efab)
  • הוספת פריטים נוספים כדי לקשר את הכתוביות או את התיאור של פריט מדיה לפריטי מדיה אחרים (Ic84bf)
  • עדכון רמת ה-API של פעולות בשורה לרמה 6. (Ie0a69)
  • הוספת קריאות חזרה להעברת הודעות ל-A4C (Ie3986)

תיקוני באגים

  • הוספת הפניות חסרות של מסמך Java עבור CarMessage. (I5db1c)
  • שינוי equals() ו-hashCode() ל-ConversationItem ו-CarMessage (I6fd10)
  • שיפור האימות של ConversationItem.mMessages (חובה להגדיר ערך שאינו null ולא ריק (Iafc51)
  • הוספת הערות @Keep לשדות ConversationItem (I5d250)
  • עדכון מסמכי התיעוד של Java לגבי קישוט שורות ופעולות משניות. (I000b6)

גרסה 1.3

גרסה 1.3.0-rc01

7 בדצמבר 2022

androidx.car.app:app-*:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 כוללת את ההצהרות האלה.

  • תיקוני באגים קלים מ-beta01. אין שינויים משמעותיים.

גרסה 1.3.0-beta01

7 בספטמבר 2022

התכונות androidx.car.app:app:1.3.0-beta01, androidx.car.app:app-projected:1.3.0-beta01, androidx.car.app:app-automotive:1.3.0-beta01 וגם androidx.car.app:app-testing:1.3.0-beta01 משוחררות. גרסה 1.3.0-beta01 מכילה את ההצהרות האלה.

תכונות חדשות

בנוסף ליכולות שנוספו לספריית האפליקציות של הרכב בגרסה 1.3.0-alpha01, הוספנו את התכונות הבאות כחלק מגרסת בטא01 (כל התכונות כאן כוללות רק שינויים בצד המארח ללא שינויים ב-API):

  • סרגל הניווט הצף ימשיך להופיע גם כשהמשתמש נמצא במסך בחירה שמבוסס על מפה ב-PlaceListNavigationTemplate, ב-RoutePreviewNavigationTemplate וב-MapTemplate. כדי לעשות זאת, מעדכנים את פרטי הניווט דרך NavigationManager.updateTrip().
  • צריך להפעיל את לחצן הפעולה עם FLAG_DEFAULT כדי להציג אנימציה של הזמן הקצוב לתפוגה. הלחצן הזה יילחץ כברירת מחדל אחרי הזמן הקצוב לתפוגה. ([API 5 - All Templates])
  • התת-טקסט של Row לא נחתך כשהמכונית חונה, אלא נחתך ל-2 שורות בזמן הנהיגה. ([API 5 - All Templates])
  • תמיכה במצב מושבת עבור Action, ‏ Toggle, ‏ Row ([API 5 - All Templates])

שינויים ב-API

  • הוספת רשימות לבחירה ללא הגבלות (I961ed)MapTemplate
  • כדי לאפשר סמלים מותאמים אישית, מסירים את האילוץ של פעולות בכותרת. (Iad28f)
  • מוסיפים אילוץ setOnClickListenerAllowed() ל-ActionsConstraints. כאשר ההרשאה Action אפשרה להגדיר את OnClickDelegate() לפעולות חוץ מסוגי הסמלים הרגילים. (TYPE_APP_ICON,‏ TYPE_BACK ו-TYPE_PAN) (I3c745)

תיקוני באגים

גרסה 1.3.0-alpha01

27 ביולי 2022

androidx.car.app:app:1.3.0-alpha01, androidx.car.app:app-projected:1.3.0-alpha01, androidx.car.app:app-automotive:1.3.0-alpha01 ו-androidx.car.app:app-testing:1.3.0-alpha01 שוחררו. גרסה 1.3.0-alpha01 כוללת את ההוספות האלה.

תכונות עם הערות ברמת API 5 תואמות ל-Android Auto מגרסה 7.9 ואילך.

תכונות חדשות

  • רמת API 5: MapTemplate חדש שאפשר להשתמש בו באפליקציות ניווט כדי להציג חלונית או רשימה של תוכן לצד מפה (If5826, ‏ If44b8)
  • רמת API 5: API חדש של CarAudioRecord שמאפשר להקליט קלט אודיו דרך המיקרופון של הרכב המארח (I5e71a)
  • רמת API 5: ממשק API חדש של SuggestionManager שמאפשר לאפליקציות לספק הצעות למארח (I5c103)
  • רמת API 5: ממשק API חדש של Alert להצגת התראות לפי הקשר ב-NavigationTemplate (I163a7, ‏ I5ad70)
  • רמת API 5: רכיבים חדשים של Header ו-MapController כדי להקל על שימוש חוזר בתבניות שונות (If5826)
  • הוספה של androidx.car.app.category.POI כקטגוריה להפעלת אפליקציות של נקודות עניין (והוצאה משימוש של androidx.car.app.category.PARKING ו-androidx.car.app.category.CHARGING) (I59da1)

שינויים ב-API

  • רמת API 5: שיטה חדשה של onClick בממשק SurfaceCallback שמאפשרת אינטראקציה במפה באמצעות הקשה (Ia9777)
  • רמת API 5: דגלים חדשים Action.FLAG_IS_PERSISTENT ו-Action.FLAG_DEFAULT לתיאור Action (I96318, ‏ I5ad70)
  • רמת API 5: מצב מופעל/מושבת חדש לרכיבים Action,‏ Row ו-Toggle (תמיכה במארח תגיע בסביבות השקת הגרסה 1.3.0-beta01 של הספרייה) (Id8a09)
  • רמת API 5: עדיפות לרכיב Header החדש דרך setHeader ב-PlaceListNavigationTemplate.Builder וב-RoutePreviewNavigationTemplate.Builder, והוצאה משימוש של השיטות הקיימות setTitle ו-setHeaderAction (I30e6a)
  • רמת API 5: שיטת setOnContentRefreshListner חדשה ב-PlaceListMapTemplate.Builder וב-PlaceListNavigationTemplate.Builder לשימוש בהטמעות של הממשק החדש OnContentRefreshListner.
  • רמת API 5: השדות החדשים setTripText ו-setTripIcon ב-TravelEstimate.Builder מאפשרים להתאים אישית את כרטיס אומדן הנסיעה (Idcc6d, ‏ Ic620d)
  • הוספת תמיכה ל-CarIconSpan בשם של PaneTemplate (Ia1ee0)
  • הוספת תמיכה ל-CarIconSpan בכותרת ובטקסט של Row (Ic1e3c)
  • מעכשיו אפשר להגדיר עד ארבע פעולות ב-ActionStrip במפה (If3522)
  • עדכון רמת ה-API של Car App ל-5 (I26b8e)
  • לא חובה להוסיף כותרות/כותרות עכשיו ל-PlaceListMapTemplate, ל-PlaceListNavigationTemplate, ל-RoutePreviewNavigationTemplate, ל-GridTemplate, ל-ListTemplate, ל-LongMessageTemplate, ל-MessageTemplate, ל-PaneTemplate ול-SignInTemplate (I2078d, Icadde)

תיקוני באגים

  • עדכנו את כללי הגודל של התמונות ב-PaneTemplate כך שיתאימו לתיבת גבול ריבועית (Idd72e)
  • תוקנה חריגה שמתרחשת אם סטאק המסך משתנה אחרי State.DESTROYED. (I3c8eb)
  • נוספה בדיקה של ערך null לאחזור סמל האפליקציה (I3f710)
  • עדכון Car Hardware API כך שישתמש ב-STATUS_UNKNOWN במקום ב-STATUS_UNAVAILABLE כברירת מחדל (Ic9444)
  • בדיקה אם המסך קיים לפני יצירת פלטפורמה (Ice027a)
  • תיקון באג מסוג CarValue.equals() שקשור ל-STATUS_UNIMPLEMENTED (I24451)

גרסה 1.2

גרסה 1.2.0

9 בנובמבר 2022

androidx.car.app:app-*:1.2.0 משוחרר. גרסה 1.2.0 כוללת את ההתחייבויות האלה.

  • זוהי גרסה יציבה, ואין בה שינויים בהשוואה לגרסה v1.2.0-rc01.

גרסה 1.2.0-rc01

23 במרץ 2022

androidx.car.app:app-*:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 כוללת את ההוספות האלה.

  • זוהי גרסה יציבה, ואין שינויים ב-API בהשוואה ל-v1.2.0-beta02. נוספו תכונות ניסיוניות חדשות (רמת API 5) שמיועדות לגרסאות עתידיות של Android Auto ו-Android Automotive.

תיקוני באגים

  • תוקן חריג שמתרחש אם מקבץ המסך השתנה אחרי State.DESTROYED. (I3c8eb)
  • עדכנו את ממשקי ה-API של CarSensors כדי לציין שהם לא מוטמעים ב-AAOS‏ (Idd57b)
  • עודכן PlaceListMapTempalte.Builder#setCurrentLocationEnabled כדי לציין ש-ACCESS_COARSE_LOCATION מספיק לתכונה (I510c2)
  • מספר היציאה הפך לאפשרות אופציונלית עבור סוגי תמרוני פנייה בצומת עגול עם זווית (Ife7d1)

גרסה 1.2.0-beta02

26 בינואר 2022

androidx.car.app:app-*:1.2.0-beta02 משוחרר. גרסה 1.2.0-beta02 מכילה את ההצהרות האלה.

עכשיו אפשר לפרסם אפליקציות לרכב שנוצרו באמצעות גרסת הספרייה הזו ומיועדות לפלטפורמה Android Automotive OS בערוץ הבדיקה הפתוח של חנות Play. אפשר לקרוא פרטים נוספים במדריך הפיתוח.

תכונות עם הערות לגבי רמת API 4 ומטה תואמות גם ל-Android Auto בגרסה 7.2 ואילך וגם לפלטפורמה החדשה של Android Automotive OS. בקטע Known Issues בהמשך מפורטות אזהרות.

שינויים ב-API

  • נוסף ממשק API setOnContentRefreshListener ניסיוני לתבניות של נקודות עניין (I6bf22)

תיקוני באגים

  • תוקנה דליפת זיכרון ב-CarAppService כשהמארח של הרכב בוטל. (I5c9ca, ‏ b/203594731)
  • עדכון javadoc של CarAppActivity כך שיכלול דרישות ל-launchmode מסוג singleTask (Id2f95)
  • מפחית את השיבושים החזותיים בקורות החיים. (Iff7e0)

בעיות מוכרות

  • המפות ActionStrip ב-PlaceListNavigationTemplate וב-RoutePreviewNavigateTemplate יתחילו להיות זמינות בגרסאות הבאות של Android Auto ו-Android Automotive OS.

גרסה 1.2.0-alpha02

15 בדצמבר 2021

androidx.car.app:app-*:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את ההוספות האלה.

תכונות שנוספו להן הערות עם רמת API 4 שודרגו מניסיוניות ליציבות, כולל מפות ActionStrip ב-PlaceListNavigationTemplate ו-RoutePreviewNavigateTemplate, בתמונה CarIcon ב-Pane, ב-QRCodeSignInMethod והיכולת להגדיר רמזים לעיבוד (למשל דגלים) ב-Action.

תכונות חדשות

  • ב-Android Auto מגרסה 7.1 ואילך, מגבלת הפריטים של Pane הוגדלה מ-2 ל-4.

שינויים ב-API

  • הוספה של שיטת toString() ניסיונית אל CarUnit(I36a3b)

תיקוני באגים

  • תוקנה קריסה שאירעה ב-CarAppPermissionActivity אם הקריאה החוזרת (callback) לא הסתיימה (If9823)
  • שינוי המגבלה של רשימת ברירת המחדל Pane ל-4 (I0068b)

גרסה 1.2.0-alpha01

3 בנובמבר 2021

androidx.car.app:app-*:1.2.0-alpha01 משוחרר. גרסה 1.2.0-alpha01 כוללת את ההוספות האלה.

כל התכונות החדשות של v1.2.0 (API 4 ואילך) הן כרגע ניסיוניות, והן מיועדות לגרסאות עתידיות של Android Auto ושל Android Automotive OS. פרטים נוספים זמינים במדריך לפיתוח.

שינויים ב-API

  • ממשק ה-API של AutomotiveCarInfo הפך לניסיוני. (Ia13e5)
  • נוספה Car App Library API ברמה 4 (I2a2e7)
  • רמת API 4: נוספה תמיכה בהגדרת CarIcon ב-Pane (Ifcc12)
  • רמת API 4: נוספה שיטת כניסה באמצעות קוד QR (Ib623e)
  • רמת API 4: נוספה אל Action set/getflags (Ic03ab)
  • רמת API 4: נוספה תמיכה בתנועת פנורמה ובתצוגה ממוגדלת ב-PlaceListNavigationTemplate וב-RoutePreviewNavigationTemplate (I9d8a3)

תיקוני באגים

  • רמת API 4: הוספת מנגנון שמאפשר לאפליקציות לשלוח עדכוני מיקום למארח הרכב (I3bad3)
  • תיקון בעיה שבה לוגיקת האימות של המארח לא מצאה כראוי את ההרשאה TEMPLATE_RENDERER (I62618)

גרסה 1.1.0

גרסה 1.1.0

15 בדצמבר 2021

androidx.car.app:app-*:1.1.0 משוחרר. גרסה 1.1.0 כוללת את השמירות האלה.

זוהי גרסה יציבה, ואין בה שינויים בהשוואה ל-v1.1.0-rc01. לפרטים נוספים על התכונות החדשות של ספריית האפליקציות לרכב, כדאי לעיין גם בנתוני הגרסה של v1.2.0-alpha02.

שינויים חשובים מאז גרסה 1.0.0

  • API ברמה 2: SignInTemplate ו-LongMessageTemplate שאפשר להשתמש בהם לתהליכי כניסה כשהרכב חונה
  • רמת API 2: תמיכה באינטראקטיביות של המפה ב-NavigationTemplate
  • רמת API 2: תמיכה בטקסט באורך רב כדי לאפשר לאפליקציות לספק מספר גרסאות של מחרוזת להצגה בהתאם לגדלים של מסכי הרכב.
  • רמת API 3: CarHardwareManagerשיכולה לשמש לשליחת שאילתות על נתוני החומרה של הרכב, כמו הדגם והיצרן, רמות הדלק וחיישנים אחרים.

גרסה 1.1.0-rc01

3 בנובמבר 2021

androidx.car.app:app-*:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 כוללת את השמירות האלה.

זוהי גרסה יציבה, ואין שינויים ב-API בהשוואה ל-v1.1.0-beta01. נוספו תכונות ניסיוניות חדשות (רמת API 4) שמיועדות לגרסאות עתידיות של Android Auto. פרטים נוספים על ממשקי ה-API הניסיוניים זמינים בהערות המוצר של v1.2.0-alpha01.

גרסה 1.1.0-beta01

1 בספטמבר 2021

androidx.car.app:app-*:1.1.0-beta01 משוחרר. גרסה 1.1.0-beta01 כוללת את ההצהרות האלה.

כל התכונות של v1.1.0 (API 2 ואילך) תואמות באופן מלא ל-Android Auto מגרסה 6.7 ואילך. אפשר לקרוא פרטים נוספים במדריך הפיתוח.

שינויים ב-API

  • הסרת את Manager כממשק ציבורי (Ie381b)
  • נוספה האפשרות להגדיר רקע מותג בהתאמה אישית לבקשת הרשאה (I74b76)
  • נוספה ScreenManager.getStackSize (I0b16a)
  • הוסרה המכונה ה-constructor של ScreenController שמקבלת את TestCarContext באופן מפורש (Iefebc)

תיקוני באגים

  • נוספה בדיקה של רמת ה-API בזמן היצירה של CarHardwareManager (I48f9b)
  • הוספנו בדיקות לשימוש לא חוקי ב-CarSpan ב-API (I65ae6)
  • תוקנה בעיה שבה אם Screen מסומן כ'סתיים' במהלך היצירה שלו, הוא משאיר את הסטאק במצב שבור (I81b13)
  • תיקון בעיה שבה תופיע שגיאה ב-CarNotificationManager.notify לגבי AutomotiveOS אם היו פעולות עם סמלים ב-CarAppExtender (I3633d)
  • נוספה שיטת לחיצת יד לאפליקציה ולמארח כדי ליצור גרסת API (I7d6f8)

גרסה 1.1.0-alpha02

21 ביולי 2021

androidx.car.app:app-*:1.1.0-alpha02 משוחרר. גרסה 1.1.0-alpha02 מכילה את התחייבויות אלה.

תכונות חדשות

  • API ברמה 3: נוספה פונקציית CarHardwareManager שאפשר להשתמש בה כדי לשלוח שאילתות לגבי נתוני החומרה של הרכב, כמו דגם ויצרן, רמות דלק וחיישנים אחרים. בשלב הזה, התכונה הזו זמינה רק ב-Android Auto מגרסה 6.7 ואילך בערוץ הבדיקה הפתוחה. כדי לבדוק את זה בסביבת מחשב, נדרשת גרסה חדשה של Desktop Head Unit שתושק בנפרד. כדאי לעקוב אחרי הדף 'בדיקת אפליקציות Android לרכבים' כדי לקבל פרטים על מועד הזמינות של הגרסה החדשה.
  • במדריך הפיתוח ובחומר העזר של הספרייה מפורטות הנחיות עיצוב ופרטים נוספים על השימוש בתכונות האלה במארחים של רכבים שתואמים ל-API ברמה 3.

שינויים ב-API

  • שיטות מחזור החיים SessionController ו-ScreenController אוחדו לשיטה אחת moveToState (I1ed00)
  • נוסף CarContext#getHostInfo() (I8977e)
  • שדות שיצאו משימוש הוסרו. (I67168)
  • עודכנו SessionController ו-ScreenController כדי לחשוף בונה באופן ישיר (Iabf22)
  • הוסר PinSignInMethod.Builder ו-ProviderSignInMethod.Builder (I9f0cb)
  • הוספנו את 'setCarAppResult()‎' כדי לאפשר שימוש באפליקציות לפי תבנית 'לצורך תוצאה' ב-AAOS‏ (I37741)
  • ממשקי CarHardware עם הערות @MainThread. (Ib2f85)
  • שינית את השם של OnCarDataListener ל-OnCarDataAvailableListener (I518ca)
  • שמות השיטות CarInfo,‏ Speed ו-Mileage ו-javadoc עודכנו. (I86672)
  • השם של Toll השתנה ל-TollCard. (I3e7c8)
  • הוסר המאפיין הלא נתמך PinSignInMethod.getPin והוחלף ב-PinSignInMethod.getPinCode (I996ce)
  • הוסר OnInputCompletedListener (הוחלף ב-InputCallback). (Ib5be1)
  • השתנתה PinSignInMethod כך שתקבל את הערך CharSequence במקום String (I275d5)

תיקוני באגים

  • תיקוני Javadoc לחומרה של רכב. (I2abbc)

תרומה חיצונית

בעיות מוכרות

  • ב-SignInTemplate, שימוש ב-InputSignInMethod עלול לגרום ל-NullPointerException במארח הרכב. הבעיה הזו תטופל במהדורה הבאה של הספרייה. כדי לעקוף את הבעיה, צריך לכלול את השורה הזו בהגדרת ProGuard של האפליקציה: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

גרסה 1.1.0-alpha01

16 ביוני 2021

התכונות androidx.car.app:app:1.1.0-alpha01, androidx.car.app:app-automotive:1.1.0-alpha01 וגם androidx.car.app:app-testing:1.1.0-alpha01 משוחררות. גרסה 1.1.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • API ברמה 2: SignInTemplate ו-LongMessageTemplate חדשים שאפשר להשתמש בהם בתהליכי כניסה כשהרכב חונה.
  • רמת API 2: תמיכה חדשה באינטראקטיביות של המפה ב-NavigationTemplate
  • API ברמה 2: תמיכה חדשה בטקסטים באורך משתנה, שמאפשרת לאפליקציות לספק כמה גרסאות של מחרוזת להצגה, בהתאם לגודלי המסכים ברכב.
  • צריך לפעול לפי ההוראות במדריך הפיתוח ובספרייה ב-Javadoc כדי לקבל פרטים נוספים והנחיות לעיצוב לגבי אופן השימוש בתכונות האלה במארחי מכוניות שתואמים לרמת API 2.

שינויים ב-API

  • כל שיטות הממשק של *Callback הוגדרו כברירת מחדל, ושם השדה OnRequestPermissionsCallback השתנה ל-OnRequestPermissionsListener (Ib3ec9)
  • עודכנו הכיתות של androidx.car.app.hardware כדי להסיר בוני ופרמטר-כיתות מיותרים. (I67beb)
  • נוספו כיתות androidx.car.app.hardware לגישה לנתונים ספציפיים לרכב, כמו דלק, סוללה ומהירות. (Iff3c9)
  • הוספת תמיכה ב-ActionStrip ב-MessageTemplate (Ida657)
  • setLoading נוסף לקבוצה MessageTemplate. (I2a4b5)
  • שינית את השם של ConnectionToCar ל-CarConnection (Ife9bd)
  • שינוי NavigationTemplate כך שיחזיר PanModeDelegate מפורש (I13877)
  • סדר הפרמטרים עודכן עבור CarContext.requestPermissions‏ (Ib890a)
  • מפתח המטא-נתונים עודכן כדי להגדיר את רמת ה-API המינימלית של המכונית ל-androidx.car.api.minCarApiLevel (Ib0d41)
  • יצירה של ממשק API שמאפשר לצפות בסטטוס החיבור לרכב (Ifc935)
  • הוספנו תמיכה בהגדרת מתג ל-Action, והוספנו את הסוג Action של מצב הפסיעה (Ica6af)
  • נוצר CarNotificationManager כדי לתמוך בשליחת התראות ברכב (I10d7a)
  • הוספת את ConstraintManager כדי להציג מגבלות על הרשימה מהמארח (I8690e)
  • נוספו API למצב הזזה ו-API לרצועת הפעולות במפה ב-NavigationTemplate (I77aa6)
  • הוספנו API לתנועה ומקיפ של מפה ב-SurfaceCallback לאפליקציות ניווט (Id5e9d)
  • הערך של CarAppApiLevel עודכן ל-2 (Ic1540)
  • נוספה האפשרות לבקש הרשאות מ-CarAppService (I5421e)
  • נוספה הערת RequiresCarApi(2) לממשק API של ריבוי טקסט (Iacb62)
  • מותר להשתמש בכמה וריאנטים של טקסט בשם התבנית של חצי הרשימה (Ib8df7)
  • נוסף LongMessageTemplate חדש (נדרש Car API ברמה 2) (Ic5cee)

תיקוני באגים

  • עדכנו את הדרישות לגבי גודל התמונה בהתאם למסכים גדולים יותר ברכב (I116dc)
  • אסור להוסיף יותר מ-2 פעולות בגוף התבנית (I32157)
  • מוודאים שכל היצירה של PendingIntent בספריית האפליקציות ברכב מגדירה דגלים. (If84fe, ‏ b/186394900)
  • בוצע עדכון של Javadoc כך שמאפשר שינויים בטקסט של Row כרענון (If3f9c)
  • androidx.activity:activity:1.2.0 הוא עכשיו יחסי תלות ב-API (Id1cb9)
  • שינינו את SignInTemplate ו-LongMessageTemplate כך שיחייבו פעולות בחנייה בלבד בגוף ההודעה, ועדכנו את המסמכים כדי לציין שהן יוצגו רק כשהרכב בחנייה (Iddaa9)
  • תוקן חריג שמתרחש במהלך פתיחת Screen במהלך ההתחלה (Ifcf40, b/184664896)
  • מותר להשתמש בצבע טקסט מותאם אישית ב-ForegroundCarColorSpan (I69e59)
  • תוקנה בעיה שבה ON_DESTROY ב-Session נצפה אחרי ON_DESTROY של Screen (I52e01, ‏ b/183696617)
  • עדכון של javadoc לגבי המקרים שבהם מותר להגדיר את הזמן שנותר ל-TravelEstimate לזמן לא ידוע. (I99610, ‏ b/183632456)
  • עודכנו Action כדי לתמוך ב-ForegroundColorSpan בכותרת ובכל צבע רקע מותאם אישית (I578e4)
  • לא לבצע את NavigationManagerCallback#onStopNavigation אם פונקציית הקריאה החוזרת נמחקת לפני שהמבצע מופעל (I7fc5e, ‏ b/181143772)
  • תוקנה בעיה שדרשה מהאפליקציה להגדיר באופן מפורש תלות ב-lifecycle-common-java8‏ (I8b8c8)

בעיות מוכרות

  • ב-SignInTemplate, המקלדת שמופיעה במסך מציגה סמל 'חיפוש' במקום סמל 'Enter' כשהמשתמש רוצה לאשר את הקלט. כפתרון זמני, המשתמשים יכולים לגשת למקלדת הטלפון שמופעל כששדה הקלט נמצא בחזית.
  • ב-Android Auto בגרסה 6.5, יכול להיות שהקריאות החוזרות (callbacks) של התנועות לזזוג ולהגדלת התצוגה ב-SurfaceCallback יופעלו באופן שגוי לגבי תנועות מגע מסוימות.

בדיקת אפליקציות לרכב, גרסה 1.0.0

גרסה 1.0.0-alpha01

24 במרץ 2021

androidx.car.app:app-testing:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את ההצהרות האלה.

זוהי הגרסה הראשונה של Jetpack לספריית הבדיקה שהקוד שלה היה סגור בעבר. בדוגמאות שלנו מוסבר איך להשתמש בספרייה הזו בבדיקות.

תכונות חדשות

  • הבקרים של כיתות המודל הוסרו. עכשיו ממשקי ה-API של המודלים הם חלק מפלטפורמת ה-API הציבורית, שמאפשרת לאמת את הערכים שהוגדרו ב-builders.
  • ה-CarAppServiceController הקודם הוחלף ב-SessionController החדש לצורך בדיקת הלוגיקה שקשורה למשך החיים של החיבור ל-hots.

גרסה 1.0.0

גרסה 1.0.0

21 באפריל 2021

androidx.car.app:app:1.0.0 משוחרר. גרסה 1.0.0 כוללת את ההצהרות האלה.

התכונות העיקריות של 1.0.0

  • בתחילת אפריל הודענו שאפשר להתחיל לפרסם אפליקציות בערוץ הייצור באמצעות androidx.car.app:app:1.0.0-rc01. ספריית האפליקציות לרכב בגרסה 1.0.0 יציבה עכשיו ותואמת באופן מלא ל-Android Auto מגרסה 6.1 ואילך.
  • צריך לפעול לפי ההוראות במדריך הפיתוח כדי להבין איך ליצור אפליקציות ניווט, חניה וטעינה ל-Android Auto באמצעות הספרייה.

תיקוני באגים

  • תוקן חריג שמתרחש במהלך פתיחת Screen במהלך ההתחלה (70aae1, b/184664896)
  • תוקנה בעיה שבה ON_DESTROY ב-Session נצפה אחרי ON_DESTROY של Screen (0ceecb, ‏ b/183696617)

גרסה 1.0.0-rc01

24 במרץ 2021

androidx.car.app:app:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את ההוספות האלה.

תיקוני באגים

  • תוקן באג של תנאי מרוץ שבו NavigationManagerCallback#onStopNavigation הופעל אחרי שהקריאה החוזרת (callback) נמחקה. מצב זה התרחש אם הקריאה החוזרת (callback) הוסרה לפני שמנהל הקריאה החוזרת פעל בפועל (I7fc5e, b/181143772)
  • תוקנה בעיה שבה האפליקציה נדרשה להגדיר באופן מפורש תלות ב-lifecycle-common-java8 (I8b8c8)
  • תוקנה שגיאת NullPointerException שהופיעה כשהאפליקציה קיבלה קריאה מסוג stopNavigation כשהיא כבר הסירה שיחה חוזרת (Ib8b89, ‏ b/181143772)
  • שיפורים כדי שלא לשלוח קריאות לאפליקציה אם מחזור החיים שלה לא נמצא לפחות במצב CREATED (I86965, ‏ b/179800224, ‏ b/177921120)
  • תוקנה בעיה שבה גרם ל-ANR במארח קריאה ל-API עם גרסה מינימלית לא חוקית שצוינה במניפסט של האפליקציה. (Iffedd, ‏ b/174231592)

גרסה 1.0.0-beta01

24 בפברואר 2021

androidx.car.app:app:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 כוללת את ההצהרות האלה.

זוהי הגרסה הראשונה של Jetpack לספריית המקור שסגורה בעבר, והיא תואמת ל-Android Auto מגרסה 6.1 ואילך. במדריך הפיתוח מוסבר איך יוצרים אפליקציות לרכב באמצעות הספרייה.

תכונות חדשות

תיקוני באגים

  • תוקנה בעיה שבה הופעל מחדש Screen שגוי כשמקפצים מסכים ברצף. (b/177590791)