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

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

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

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

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

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

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

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

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

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

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

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

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

משוב

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

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.9

גרסה ‎1.9.0-alpha02

‫9 בספטמבר 2026

‫androidx.car.app:app-*:1.9.0-alpha02 מופץ. גרסה ‎1.9.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• עיצוב אפליקציות: נוסף CarAppThemeSource כדי לאפשר לאפליקציות להצטרף לעיצוב מותאם למותג, ולאפשר למארחים לשאול על הגדרות העיצוב המועדפות.
• כותרת חיפוש: נוסף SearchHeader ל-SectionedItemTemplate כחלופה לכותרת חיפוש ב-API 9.
• עיצוב רכיבים: נוספה תמיכה בעיצוב של כרטיסיות (TabStyle), באנרים (BannerStyle) ואמצעי בקרה של מדיה/אינדיקטורים של התקדמות (MediaPlaybackStyle,‏ StrokeCap).

שינויים ב-API

• סגנון של סרגל המדיה וההתקדמות: נוספו MediaPlaybackStyle, setMediaAccentColor ו-StrokeCap עצמאי כדי להתאים אישית את אמצעי הבקרה של ההפעלה ואת אינדיקטורי ההתקדמות. בוצע עדכון של CarProgressBarStyle כדי לתמוך בצבעים שניתן להגדיר כ-nullable, והוסרו מ-CarProgressBar שיטות צבע שהוצאו משימוש. (Ib45c6, I17141, I270a4, I10fe4, I80a17)
• עיצוב אפליקציות: הוספנו את CarAppThemeSource להסכמה להשתתפות בעיצוב אפליקציות ציבוריות, והוספנו את onGetAppTheme ל-CarAppService (עם IPC תואם) כדי לאפשר למארחים לשלוח שאילתות לגבי הגדרות העיצוב המועדפות. (I108f8, ‏ Ifbd41, ‏ I97c7e)
• עיצוב כרטיסיות: נוספה תמיכה בצבעי רקע בהתאמה אישית, בצבעי תוכן/טקסט וברדיוסים של פינות בהתאמה אישית באמצעות TabStyle. (I07330, Id09f6)
• גודל סמלים ותמונות: הוצא משימוש IMAGE_TYPE_ICON ב-Row, ב-GridItem, ב-Banner וב-CondensedItem לטובת קבועי הגודל IMAGE_TYPE_SMALL ו-IMAGE_TYPE_MEDIUM, שבהם הסמלים מוצגים כברירת מחדל ללא גוון. שינינו את CarIconStyle והוספנו תמיכה בצורות בהתאמה אישית ל-CarIcon. (Ie57fa, ‏ I5cc2d, ‏ Ic9584, ‏ Iaef57)
• מודעות באנר: נוספו BannerStyle לצורות מותאמות אישית ולרדיוסים של פינות, נוספו אפשרויות של וריאציות של תמונות (IMAGE_TYPE_SMALL, ‏IMAGE_TYPE_LARGE), והוסרו ממשקי API של סמלים ורקעים שהוצאו משימוש לטובת setLeadingImage ו-addTrailingImage. (I265bb, ‏ I7d28a, ‏ I23f62, ‏ I2917e, ‏ I95b1c)
• כותרות ופריסה: נוסף SearchHeader ל-SectionedItemTemplate ב-API 9, נוסף startHeaderImage ל-Header לסמלי התחלה מותאמים אישית, ונוסף incompleteLastRowStrategy כדי לשלוט בטיפול בשורות או בעמודות חלקיות ברשת, בקטעים מצומצמים ובקטעים מודגשים. (I86632, ‏ I24937, ‏ If64be)

תיקוני באגים

• הוספנו הבהרה שלפיה המערכת מתעלמת מ-Action.TYPE_MEDIA_PLAYBACK כלחצן FAB של תבנית במארחים של Car API בגרסה 9 ואילך. (Ie8fd4)

גרסה ‎1.9.0-alpha01

‫19 במאי 2026

‫androidx.car.app:app-*:1.9.0-alpha01 מופץ. הוספנו תכונות חדשות כדי להגביר את הגמישות בשימוש בתבניות:

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

גרסה ‎1.9.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו את Banner ואת BannerSection, כך שאפשר להוסיף את Banners אל SectionedItemTemplate. (Id5dd2, ‏ b/505494611)
• נוספה NavigationManager.setVoiceAssistantCapabilities כדי לאפשר לאפליקציות ניווט לשלוח את היכולות של העוזר הדיגיטלי ואת סטטוס ההסכמה למארח. (I34c93, ‏ b/489625791, ‏ b/486967456)
• נוסף NavigationVoiceAssistantCapabilities API לאפליקציות ניווט, שמאפשר להן להצהיר על פעולות קוליות נתמכות, שיבושים וסטטוס ההסכמה של העוזר הקולי. (I79d3e, ‏ b/489625791, ‏ b/486967456)
• השקה של CarAppApiLevel 9 (I87656, ‏ b/501233317)
• הוספת API להגדרת הצורה של Chip או ChipSection באמצעות ChipStyle (I1fcfc, ‏ b/505086379)
• הוספנו ממשקי API חדשים, CondensedItem ו-CondensedSection, כדי לתמוך בפריסות עם דחיסות גבוהה של פיקסלים ב-SectionedItemTemplate. (Iabaa8, ‏ b/499350859)
• הוספנו תמיכה ניסיונית בכתוביות בכותרת ומודל חדש של רקע. (I66b5b)

גרסה 1.8

גרסה ‎1.8.0-rc01

‫26 באוגוסט 2026

androidx.car.app:app-*:1.8.0-rc01 מופצת וכוללת את אותן תכונות כמו גרסה 1.8.0-beta01. גרסה ‎1.8.0-rc01 מכילה את השמירות האלה.

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

גרסה ‎1.8.0-beta01

‫22 באפריל 2026

‫androidx.car.app:app-*:1.8.0-beta01 מופץ. גרסה ‎1.8.0-beta01 מכילה את השמירות האלה.

תכונות חדשות

• הוספנו תמיכה בתבנית Sectioned Item, שמאפשרת פריסות מורכבות יותר של רשימות ורשתות.
• תמיכה משופרת בהפעלת מדיה.
• הוספנו תמיכה ב-IMAGE_TYPE_MEDIUM ב-RowImageType.
• נוספה פעולת Intent‏ ACTION_MEDIA_SHOW_PLAYBACK_VIEW להפעלת מסכי הפעלת מדיה.

שינויים ב-API

• הוספנו תמיכה ב-IMAGE_TYPE_MEDIUM ב-RowImageType (I76108)
• הוספת פעולת כוונה ACTION_MEDIA_SHOW_PLAYBACK_VIEW. כששולחים את הפעולה הזו לפעילות שתומכת בה, היא מציינת שהאפליקציה צריכה להפעיל את מסך ההפעלה שלה, או מסך רלוונטי אחר (If29db, ‏ b/455949944)

תיקוני באגים

• שינוי התנהגות ברירת המחדל של SectionedItemTemplate הקרוב כדי לשמור את מצב הגלילה בין רענוני תבניות ופעולות חזרה (I6c9cc, b/461256656)

גרסה ‎1.8.0-alpha03

‫19 בנובמבר 2025

‫androidx.car.app:app-*:1.8.0-alpha03 מופץ. גרסה ‎1.8.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

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

שינויים ב-API

• נוסף endImageType בשביל endImages ב-Rows‏ (I8865b)
• מוסיפים את SectionedItemTemplate#alphabeticalIndexingStrategy. זוהי החלפה של #isAlphabeticalIndexingAllowed, והיא מספקת למפתחים אפשרויות נוספות לאינדקס אלפביתי. (Ia164d, ‏ b/410092683)
• הוספת תמיכה בתמונת סיום לשורה באפליקציה לרכב. ‫(If93f0)
• נוספה האפשרות CarIcon MediaPlayback כדי לפשט את השימוש בפעולה רגילה MediaPlayback. (Ib6cb7)

תיקוני באגים

• העברת ברירת המחדל minSdk מ-API 21 ל-API 23 ‏ (Ibdfca, ‏ b/380448311, ‏ b/435705964, ‏ b/435705223)

גרסה ‎1.8.0-alpha02

‫18 ביוני 2025

‫androidx.car.app:app-*:1.8.0-alpha02 מופץ. גרסה ‎1.8.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

• נוספה תמיכה ב-Action.MEDIA_PLAYBACK שבו מוצג אינדיקטור על סמך מצב הפעלת המדיה.
• הוספנו תמיכה בשליטה במיקום הגלילה של משתמש כשמרעננים את SectionedItemTemplate.

שינויים ב-API

• הוספת תמיכה בשמירת מיקום הגלילה של משתמש בתוך SectionedItemTemplate בין רענונים. (Ia4c51)
• הפעולה MEDIA_PLAYBACK עודכנה כדי להפעיל אותה לפעולה בסוף השורה (I05cc4)
• הוספת סוג פעולה חדש (I6cc5a)
• מוסיפים CarAppExtender#addAction(Action) כדי שאפשר יהיה להוסיף ל-CarAppExtender כל סוג של פעולה. (Idc4d7)
• הפכנו את SectionedItemTemplate לנגיש ל-API מגרסה 8 ואילך. (I9a079)

גרסה ‎1.8.0-alpha01

‫20 במאי 2025

‫androidx.car.app:app-*:1.8.0-alpha01 מופץ. גרסה ‎1.8.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

כל היכולות זמינות כרגע רק ב-Android Auto. אותם ממשקי API ישמשו בכל AAOS

• נוספה קטגוריית מדיה ליצירת אפליקציה בהתאמה אישית, כחלופה לאפליקציות שמבוססות על MediaBrowse
• נוסף Playback Template (תבנית הפעלה) שמאפשר לשלוט בפעולות העליונות במהלך הצגת הפעלת המדיה (זמין רק באפליקציות מדיה)
• נוסף תמיכה מלאה בתבנית Sectioned Item ב-Android Auto, שמאפשרת שילובים של קטעי משנה שמורכבים מרשימות או מרשתות.
• הוספנו את המידה 'גדול במיוחד' כמידה נוספת לפריטים ברשת.

שינויים ב-API

• הוספת אפשרות גודל נוספת לפריטים ברשת (I35b58)
• הוספת קטגוריה והרשאה לאפליקציות מדיה לספריית האפליקציות לרכב (I8e100)
• הוספנו API חדש לאפליקציות כדי לזהות אם קטגוריית המדיה CarAppLibrary נתמכת (Ic4b08)
• הוספת את OnItemVisibilityChangeListener לקטע. (I2c2fd)
• נוספה התכונה Mileage#getOdometerKilometers והוצאה משימוש התכונה Mileage#getOdometerMeters (Ic91af)

תיקוני באגים

• תיקון שגיאת הקלדה ב-Javadoc של CarIcon.setTint (Iabd72)
• עדכנו את Row.Builder#setNumericDecoration התיעוד כדי לשקף את העובדה שפעולה אחת + קישוט מספרי לא אפשרי; עם זאת, 0 או 2 פעולות + קישוט מספרי אפשרי. (Ic0b08)
• נוסף שדה לצבע הרקע של סמל התג בפריטים בתצוגת רשת. (I2b6ae)

גרסה 1.7

גרסה 1.7.0

‫16 ביולי 2025

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

• זו הגרסה היציבה הראשונה שכוללת את התיקון ל-CVE-2024-10382 שתוקן בגרסה beta03. אם אתם משתמשים בגרסה נמוכה מ-1.7-beta03, אתם צריכים לעדכן כדי להשתמש בגרסה הזו.

גרסה ‎1.7.0-rc01

‫15 בינואר 2025

‫androidx.car.app:app-*:1.7.0-rc01 יוצאת ללא שינויים משמעותיים מגרסת בטא03. גרסה ‎1.7.0-rc01 מכילה את השמירות האלה.

• זוהי גרסת ה-RC הראשונה שכוללת את התיקון ל-CVE-2024-10382 שתוקן בגרסה beta03. אם אתם משתמשים בגרסה נמוכה מ-1.7-beta03, אתם צריכים לעדכן כדי להשתמש בגרסה הזו.

גרסה ‎1.7.0-beta03

‫13 בנובמבר 2024

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

‫androidx.car.app:app-*:1.7.0-beta03 מופץ. גרסה ‎1.7.0-beta03 מכילה את השמירות האלה.

שינויים ב-API

• מעדכנים את קוד הסריאליזציה והדה-סריאליזציה של CAL כך שיטפל רק באובייקטים שההערה @CarProtocol מוצהרת עליהם. (Ic730e)
• עכשיו אפשר להשתמש ב-CarAppExtender כדי להרחיב את המסגרת Notification.Builder במקום רק ב-NotificationCompat.Builder. (Id3ad7)
• הוספת KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST. (I201f9)
• הוצאה משימוש של הבונה הריק ב-ConversationItem והחלפה שלו בבונה שמקבל פרמטרים נדרשים. בנוסף, מתווספת בדיקה כדי להגן מפני הודעות ריקות. (Ic8221)

תיקוני באגים

• מוודאים שבמיפוי PlaceList נעשה שימוש בכותרת מחרוזת (טקסט בלבד). (Ic992f)
• הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחי Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זוהי ברירת המחדל החל מגרסה 2.1.0 של מהדר Kotlin). (Ib5367, ‏ b/326456246)

גרסה ‎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 בבונה @ExperimentalCarApi במחלקה TabContents.Builder (I26fbe)
• הוספת פעולת Intent ונתונים נוספים עבור CarMediaApp (I50782)
• סימון ממשקי API להעברת הודעות כלא ניסיוניים (I0b070)
• הוספת טעינה של פריטים מרוחקים אל SectionedItemTemplate (מאפשרת לטעון רשימות ארוכות בלי שהן יקרסו) (I0d122)
• הוספנו את SectionedItemTemplate לרשימת התבניות הנתמכות בתוך TabTemplate ב-API 8. (Idc5d6)

תיקוני באגים

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

גרסה ‎1.7.0-beta01

‫26 ביוני 2024

‫androidx.car.app:app-*:1.7.0-beta01 מופץ. גרסה ‎1.7.0-beta01 מכילה את השמירות האלה. התכונות זהות לאלה שפורסמו בגרסת אלפא01, שמופיעות שוב בהמשך:

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

• תוקנו מקרים מסוימים של דליפות זיכרון וקריסות בקוד הלקוח של CAL ובאפליקציית הדוגמה CAL Navigation. ‏(I55e04)
• כדי למנוע קריסות, מחליפים את requireNotNull instances בשיטה 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.
• פריט בשיחה: ממשקי API חדשים להצגת שיחות (צ'אט, SMS) וקריאה של Assistant ברכב.
• מידות הרכב: API חדש לאחזור מידות הרכב (הנתונים זמינים ב-AAOS בשלב הזה).

שינויים ב-API

• סימון סוג התמונה בשורה 'קטנה במיוחד' כניסיוני (I5184b)
• נוסף CarInfo#fetchExteriorDimensions API שמאפשר גישה למידע על המידות החיצוניות של הרכב, כמו גובה, רוחב וכו' (Ia40c5)
• הוסר התג ExperimentalAPI מ-MapWithContentTemplate (I66db8)
• מעדכנים את הפרמטר GridItem#setTitle כך שניתן יהיה להגדיר אותו כ-nullable. (I3d610)
• ‫GetHeader API לא דורש API 7 כי הוא תואם לדור קודם (I8c812)
• הוספת תמיכה ב-Header ב-ListTemplate, הוצאה משימוש של headerAction, headerTitle, actionStrip (I7ae01)
• הוצאה משימוש של title,‏ headerAction ו-actionStrip ב-GridTemplate והוספת תמיכה ב-Header (I41a9c)
• הסרת הדרישה לרמה 7 עבור ממשקי API ניסיוניים: Badge, ‏ GridTemplate item size ו-image shape getters/setters, ‏ GridItem שיטות לקבלת/הגדרת Badge. (Id71eb)
• הוצאה משימוש של title, ‏ headerAction, ‏ actionStrip ב-PaneTemplate, הוספת תמיכה חדשה ב-Header (I23154)
• הטלמטריה של Media Center השתנתה מ-BroadcastReceiver ל-Browse Custom Action. (I4185f)
• הוספנו תמיכה במאפיין Header ב-MessageTemplate. התמיכה ב-ActionStrip, ‏ headerAction ו-title הוצאה משימוש. (Ie2de8)
• שינוי החשיפה הקבועה של ההתראה (Icf8a8)
• הסרת המאפיין isLoading מתבנית האב (I651e6)
• הוספת תוספים כדי ליידע אפליקציות מדיה לגבי הפרמטרים העיקריים של ממשק המשתמש (I85ca2)
• הוספת תכונת ניתוח הנתונים של מרכז המדיה אל 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. עדכון מאמרי העזרה של MapWithContentTemplate API‏ (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)
• הוספת מאפיין של תג ל-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)
• הוספת קריאות חוזרות (callback) להעברת הודעות ל-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 מכילה את השמירות האלה.

• תיקוני באגים קלים מגרסת בטא01. אין שינויים משמעותיים.

גרסה ‎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 מכילה את השמירות האלה.

• אפליקציות לרכב שנבנו באמצעות הספרייה הזו יכולות לעבור עכשיו לחנות Play באמצעות רמת API‏ 5 (אפשר לעיין במדריך הפיתוח שלנו). תכונות שמסומנות ברמת API 5 ומטה תואמות ל-Android Auto מגרסה 8.1 ואילך ול-Google Automotive App Host מגרסה 1.4 ואילך.

תכונות חדשות

בנוסף ליכולות שנוספו ב-Car App Library 1.3.0-alpha01, התכונות הבאות נוספו כחלק מ-beta01 (כל התכונות כאן כוללות רק שינויים בצד המארח ללא שינויים ב-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

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

תיקוני באגים

• נוספה תאימות של Android Automotive Template Host 1.4+‎ למסכים קעורים ([Host change])

גרסה ‎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 Level 5: שיטת onClick חדשה בממשק SurfaceCallback שמאפשרת הקשה על אינטראקטיביות במפה (Ia9777)
• רמת API‏ 5: נוספו הדגלים Action.FLAG_IS_PERSISTENT ו-Action.FLAG_DEFAULT לתיאור Actions (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: method חדש setOnContentRefreshListner ב-PlaceListMapTemplate.Builder וב-PlaceListNavigationTemplate.Builder לשימוש בהטמעות של הממשק החדש OnContentRefreshListner.
• רמת API‏ 5: רכיבים חדשים setTripText ו-setTripIcon ב-TravelEstimate.Builder להתאמה אישית של כרטיס הערכת משך הנסיעה (Idcc6d, ‏ Ic620d)
• הוספת תמיכה ב-CarIconSpans בשם של PaneTemplate (Ia1ee0)
• הוספת תמיכה ב-CarIconSpans בכותרת ובטקסט של Row (Ic1e3c)
• מעכשיו אפשר להוסיף עד ארבע פעולות למפות ActionStrip (If3522)
• עדכון רמת Car App API ל-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)
• בוצע עדכון של ממשק CarSensors API כדי לציין שהוא לא מיושם ב-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 מכילה את השמירות האלה.

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

תכונות שמסומנות ברמת 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)

בעיות מוכרות

• המפה ActionStrips ב-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 שודרגו מניסיוניות ליציבות, כולל המפה ActionStrips ב-PlaceListNavigationTemplate וב-RoutePreviewNavigateTemplate, התמונה CarIcon ב-Panes,‏ QRCodeSignInMethod והאפשרות להגדיר רמזים לעיבוד (למשל, דגלים) ב-Actions.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

• תוקנה קריסה שקרתה ב-CarAppPermissionActivity אם הקריאה החוזרת לא פעילה (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

• הפכנו את AutomotiveCarInfo API לניסיוני. (Ia13e5)
• נוספה רמת API‏ 4 של Car App Library‏ (I2a2e7)
• רמת API‏ 4: הוספנו תמיכה בהגדרת CarIcon ב-Pane ‏ (Ifcc12)
• רמת API‏ 4: נוספה שיטה להתחברות באמצעות קוד QR‏ (Ib623e)
• רמת API‏ 4: נוספו הפונקציות set/getFlags ל-Action (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 Level 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)
• הוסר בנאי 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 Level 3: נוסף CarHardwareManager שאפשר להשתמש בו כדי לשלוח שאילתות לגבי נתוני החומרה של הרכב, כמו הדגם והיצרן, רמות הדלק וחיישנים אחרים. בשלב הזה, התכונה הזו זמינה רק ב-Android Auto בגרסה 6.7 ומעלה בערוץ הבדיקות הפתוח. כדי לבדוק את זה בסביבת מחשב, צריך להשתמש בגרסה חדשה של Desktop Head Unit שתופץ בנפרד. בקרוב יפורסמו פרטים נוספים על המועד שבו הגרסה החדשה תהיה זמינה בדף בדיקת אפליקציות ל-Android Auto.
• פרטים נוספים והנחיות עיצוב לשימוש בתכונות האלה במארחי מכוניות שתואמים לרמת API 3 זמינים במדריך למפתחים ובחומר העזר לספרייה.

שינויים ב-API

• איחדנו את שיטות מחזור החיים SessionController ו-ScreenController לשיטה אחת moveToState (I1ed00)
• נוסף CarContext#getHostInfo() (I8977e)
• הוסרו שדות שיצאו משימוש. (I67168)
• הפונקציות SessionController ו-ScreenController עודכנו כדי לחשוף constructors באופן ישיר (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 Level 2: תמיכה חדשה בטקסט באורכים שונים, כדי לאפשר לאפליקציות לספק כמה גרסאות של מחרוזת להצגה בהתאם לגדלי המסכים ברכב.
• פרטים נוספים והנחיות עיצוב לשימוש בתכונות האלה במערכות מולטימדיה לרכב שתואמות לרמת API 2 זמינים במדריך למפתחים וב-Javadoc של הספרייה.

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

גרסה 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 נוקה. הבעיה הזו קרתה אם הקריאה החוזרת נוקתה לפני שהקריאה החוזרת הופעלה בפועל (I7fc5e, ‏ b/181143772)
• תוקנה בעיה שדרשה מהאפליקציה להסתמך באופן מפורש על lifecycle-common-java8 (I8b8c8)
• תוקנה בעיה NullPointerException שקרתה כשהאפליקציה קיבלה קריאה ל-stopNavigation אחרי שהוסרה ממנה קריאה חוזרת (Ib8b89, b/181143772)
• שיפורים שמונעים שליחת קריאות לאפליקציה אם מחזור החיים שלה לא נמצא לפחות במצב CREATED (I86965, ‏ b/179800224, ‏ b/177921120)
• תוקנה בעיה שבה ציון של API מינימלי לא תקין במניפסט של האפליקציה גרם לשגיאה, וכתוצאה מכך ל-ANR במארח. (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 ומעלה. במדריך למפתחים מוסבר איך ליצור אפליקציות לרכב באמצעות הספרייה.

תכונות חדשות

• הוספנו את הרכיב GridTemplate שאפשר להשתמש בו באפליקציה כדי להציג רשימה של רכיבי ממשק משתמש בפריסת רשת.
• הוספנו שיטה CarAppService.createHostValidator לאימות של חיבור מארח ממקור מהימן (לדוגמה, Android Auto).
• הוספנו API של CarAppExtender.Builder.setColor. (b/174231592)

תיקוני באגים

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