Compose for TV

  
מספקת למפתחים פונקציות של Compose ו-Material Design כדי לכתוב אפליקציות לטלוויזיה

בטבלה הזו מפורטים כל פריטי המידע בקבוצה androidx.tv.

פריט מידע שנוצר בתהליך פיתוח (Artifact) גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
tv-material 1.1.0 - - -
tv-foundation 1.0.0 - - -
הספרייה הזו עודכנה לאחרונה בתאריך: 6 במאי 2026

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

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

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

Groovy

dependencies {
    implementation "androidx.tv:tv-material:1.1.0"
    implementation "androidx.tv:tv-foundation:1.0.0"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-material:1.1.0")
    implementation("androidx.tv:tv-foundation:1.0.0")
}

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

משוב

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

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

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

אין הערות לגבי הגרסה של הארטיפקט הזה.

Tv-Material

גרסה 1.1

גרסה 1.1.0

‫6 במאי 2026

androidx.tv:tv-material:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

גרסה ‎1.1.0-rc01

‫8 באפריל 2026

androidx.tv:tv-material:1.1.0-rc01 מופץ. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

‫11 במרץ 2026

androidx.tv:tv-material:1.1.0-beta01 מופץ. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5,‏ b/344563182)

External Contribution

  • האפשרות androidx.compose.ui.graphics.NativePaint typealias הוצאה משימוש. במקומה יש להשתמש ישירות ב-android.graphics.Paint (I6303c,‏ b/477394763)
  • החלפת התוסף Paint.asFrameworkPaint() בתוסף Paint.nativePaint כדי למנוע חשיפה של סוג הפלטפורמה ל-commonMain sourceset דרך typealias (I6303c, ‏ b/477394763)

גרסה ‎1.1.0-alpha01

‫15 בינואר 2025

androidx.tv:tv-material:1.1.0-alpha01 מופץ. גרסה ‎1.1.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • החלפת FocusEnterExitScope.cancelFocus() ב-cancelFocusChange()(I89959)
  • הפרמטרים FocusProperties.enter ו-FocusProperties.exit הוחלפו בפרמטרים onEnter ו-onExit, בהתאמה,באמצעות היקף של מקבל במקום הפרמטר FocusDirection. (I6e667)

תיקוני באגים

  • העברנו את CompositingStrategy.OffScreen מ-Surface ל-Text כדי לתקן את הטקסט המקפץ בזמן שינוי הגודל. (I92b15f17)
  • תוקן ניהול המיקוד בקרוסלה (Ie508b721375)
  • למשטח (לא אינטראקטיבי) יש יישום פשוט יותר בהשוואה למשטחים אינטראקטיביים. (I7ea545150)

גירסה 1.0

גרסה 1.0.1

‫16 ביולי 2025

androidx.tv:tv-material:1.0.1 מופץ. גרסה 1.0.1 מכילה את השמירות האלה.

תיקוני באגים

  • הגובה של NavigationDrawerItem עודכן בהתאם למפרטים. (cf9a3ce)
  • העברנו את ההגדרה של אסטרטגיית הקומפוזיציה מהרכיב הקומפוזבילי Surface לרכיב הקומפוזבילי Text. התיקון הזה פותר את הבאג שבו Exoplayer לא ביצע רינדור ב-Surface composables בגרסאות נמוכות יותר של Android API. (9858ffb)

גרסה 1.0.0

‫21 באוגוסט 2024

androidx.tv:tv-material:1.0.0 מופץ. גרסה 1.0.0 היא הגרסה היציבה הראשונה של androidx.tv:tv-material.

גרסה ‎1.0.0-rc02

‫7 באוגוסט 2024

androidx.tv:tv-material:1.0.0-rc02 מופץ. גרסה ‎1.0.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקנה אנימציה של טקסט עם רעידות ברכיב קומפוזבילי מסוג Surface. (3163319)

גרסה ‎1.0.0-rc01

‫10 ביולי 2024

androidx.tv:tv-material:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫1 במאי 2024

androidx.tv:tv-material:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • הפונקציה ColorScheme ופונקציות העזר שלה יציבות עכשיו. (If34fa)
  • גרסה LocalContentColor יציבה עכשיו (I60ee2)
  • ממשק ה-API של Typography יציב עכשיו (I088d6)
  • ממשקי Shapes API יציבים עכשיו (I0f5f4)
  • ‫Border API יציב עכשיו (I69281)
  • ‫Glow API יציב עכשיו (Iea5f1)
  • רכיב הסמל יציב עכשיו (I62c2d)
  • LocalTextStyles API יציב עכשיו (Iaded8)
  • MaterialTheme ה-API יציב עכשיו (I2f541)
  • רכיב הטקסט יציב עכשיו (Ib9e31)
  • הרכיב RadioButton יציב עכשיו (Ia03c8)
  • רכיב המתג יציב עכשיו (I6cea3)
  • רכיבי Checkbox יציבים עכשיו (I7eafc)
  • רכיבי Surface יציבים עכשיו (I58758, ‏ I04aca)
  • השם של NonInteractiveSurfaceDefaults שונה ל-SurfaceDefaults והשם של NonInteractiveSurfaceColors שונה ל-SurfaceColors (I0812e)
  • עכשיו, במקום המונח 'סימון', המונח 'בחירה' משמש לתיאור משטחים שאפשר לבחור בהם, כי לשני המונחים יש משמעויות סמנטיות שונות (I5a206)
  • NavigationDrawer ו-NavigationDrawerScope יציבים עכשיו (I249c1)
  • הרכיב NavigationDrawerItem יציב עכשיו (Id6986)
  • הכרטיסייה והרכיבים של TabRow יציבים עכשיו (I92d92)
  • הרכיבים Button, OutlinedButton, IconButton, OutlinedIconButton ו-WideButton יציבים עכשיו (Ib4de8)
  • המרכיבים Card, ‏ ClassicCard, ‏ CompactCard, ‏ WideClassicCard, ‏ StandardCardContainer ו-WideCardContainer יציבים עכשיו (I34390)
  • השם של StandardCardLayout שונה ל-StandardCardContainer והשם של WideCardLayout שונה ל-WideCardContainer (I08883)
  • הוסר CardContainerDefaults.ImageCard ושם CardDefaults.ContainerGradient שונה ל-CardDefaults.ScrimBrush (I6adfe). אפשר להשתמש ב-Card במקום ב-CardContainerDefaults.ImageCard במאגרי הכרטיסים.
  • גרסאות ListItem ו-DenseListItem יציבות עכשיו (Idebd9)
  • הסרטונים ListItemDefaults.ListItemShape, ListItemDefaults.FocusedDisabledBorder ו-ListItemDefaults.SelectedContainerColorOpacity הם עכשיו פרטיים (I5d533)
  • שינינו את הסדר של הפרמטרים של ListItem ושינינו את השם של ListItemDefaults.ListItemElevation ל-ListItemDefaults.TonalElevation (Id6841). הפרמטר headlineContent הועבר לחלק העליון של הקומפוזבילי. בעבר, יכולתם להשתמש בתחביר של Kotlin ל-lambda מסוג trailing כדי להעביר את headlineContent. עכשיו תצטרכו להשתמש בתחביר של פרמטרים עם שמות כדי לספק את headlineContent.
  • LocalAbsoluteTonalElevation הוא עכשיו פנימי (Ibfc65)
  • הרכיב ImmersiveList הוסר. כדי ללמוד איך ליצור אותה בעצמכם, אפשר לעיין בדוגמה הזו. (Id48da)
  • רכיבי tv-material שחושפים MutableInteractionSource בממשק ה-API שלהם עודכנו כך שהם חושפים עכשיו MutableInteractionSource שניתן להגדיר כ-nullable, וערך ברירת המחדל שלו הוא null. אין כאן שינויים סמנטיים: העברת הערך null פירושה שאתם לא רוצים להעביר את MutableInteractionSource, והוא ייווצר בתוך הרכיב אם יהיה צורך בכך. שינוי ל-null מאפשר לרכיבים מסוימים לא להקצות MutableInteractionSource אף פעם, ולרכיבים אחרים ליצור מופע רק כשצריך, מה שמשפר את הביצועים ברכיבים האלה. אם אתם לא משתמשים ב-MutableInteractionSource שאתם מעבירים לרכיבים האלה, מומלץ להעביר במקומו את הערך null. מומלץ גם לבצע שינויים דומים ברכיבים שלכם. (I309b4, b/298048146)
  • הפרמטר TextAlign של רכיב הטקסט בטלוויזיה הוא עכשיו לא null‏ (Ib73b1, b/299490814)
  • הוספנו ערך מיוחד של 'לא צוין' לשדות TextAlign, TextDirection, Hyphens ו-LineBreak של ParagraphTextStyle כדי להחליף את (I4197e, b/299490814)

שינויים בהתנהגות

  • ערך ברירת המחדל של הפרמטר shape עבור Surface לא אינטראקטיבי השתנה ל-RectangleShape (I1b859cb)
  • חלק מהתכונות של הקרוסלה הושמטו בהשקה של גרסת הבטא כי ממשקי ה-API הנדרשים הם ניסיוניים (I0e755d4)
  • השינוי של contentColor ב-Surface לא מונפש יותר בין מצבים (I436e794f)

Tv-Foundation

גירסה 1.0

גרסה 1.0.0

‫6 במאי 2026

androidx.tv:tv-foundation:1.0.0 מופץ. גרסה 1.0.0 מכילה את השמירות האלה.

גרסה ‎1.0.0-rc01

‫8 באפריל 2026

androidx.tv:tv-foundation:1.0.0-rc01 מופץ. גרסה ‎1.0.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.0.0-beta01

‫11 במרץ 2026

androidx.tv:tv-foundation:1.0.0-beta01 מופץ. גרסה ‎1.0.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • כדי להשתמש בפרויקטים שפורסמו עם Kotlin 2.0, צריך KGP 2.0.0 או גרסה חדשה יותר (Idb6b5,‏ b/344563182)

גרסה ‎1.0.0-alpha12

‫15 בינואר 2025

androidx.tv:tv-foundation:1.0.0-alpha12 מופץ. גרסה ‎1.0.0-alpha12 מכילה את השמירות האלה.

שינויים ב-API

  • ניקוי פריסות עצלות מ-tv-foundation. כדי להפסיק להשתמש בפריסות עצלות של tv-foundation, אפשר לעיין בהערות המוצר של גרסה 1.0.0-alpha11. (I2fdd3, b/358913893)

גרסה ‎1.0.0-alpha11

‫10 ביולי 2024

androidx.tv:tv-foundation:1.0.0-alpha11 מופץ. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

  • הוצאנו משימוש את הפריסות העצלניות לטלוויזיה מהספרייה tv-foundation. בכרטיס הזה מוסבר איך להפסיק להשתמש בפריסות העצלניות לטלוויזיה. (I0855f, b/332674072)
  • PlatformImeOptions היא עכשיו מחלקה קונקרטית במקום ממשק. (If40a4)

גרסה ‎1.0.0-alpha10

‫4 באוקטובר 2023

androidx.tv:tv-foundation:1.0.0-alpha10 וגם androidx.tv:tv-material:1.0.0-alpha10 מופצים. גרסה ‎1.0.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

  • השקנו את NavigationDrawerItem לשימוש ב-NavigationDrawer וב-ModalNavigationDrawer. (I4b491)
  • הוספת פרופיל בסיסי לספריית tv-foundation. ‏(2b57fd7)
  • הוספת פרופיל בסיסי לספריית tv-material. (1711ff5)

שינויים ב-API

  • שינית את השם של NavigationDrawerScope.doesTabRowHaveFocus לNavigationDrawerScope.hasFocus. (I8286b)
  • השם של TabRowScope.isActivated שונה ל-TabRowScope.hasFocus. (Ic4273)

תיקוני באגים

  • תיקון התאימות של קרוסלה עם פריטים סמוכים שמשתמשים בממשקי API של focus restorer. (7b2a7a4)
  • משביתים את ההדגשה של ההצגה ברמות API נמוכות מ-28, כי היא לא נתמכת על ידי מערכת ההפעלה. (6d3616f)
  • תוקן קראש מסוג ANR שנגרם בגלל מיקום לא תקין של פריטים במאגרי תגים עצלים כשגוללים במהירות בכיוון הפוך. (642d65c)
  • הוסר ריווח פנימי ברקע במגירת הניווט של חלון העזר. (69965b2)
  • תיקון של Scrim בחלונית ההזזה לניווט כך שיימשך מעל תוכן הרקע ולא מאחוריו. (d4bbefb)

גרסה ‎1.0.0-alpha09

‫6 בספטמבר 2023

androidx.tv:tv-foundation:1.0.0-alpha09 וגם androidx.tv:tv-material:1.0.0-alpha09 מופצים. גרסה ‎1.0.0-alpha09 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו ממשק ReusableComposition לניהול מחזור החיים של רכיבי משנה ושימוש חוזר בהם. (I812d1, ‏ b/252846775)
  • סנכרון של פיצול tv-foundation עם compose-foundation. (I737c3, b/287011882)
  • נוספה פונקציית עומס יתר של LazyLayout, שמקבלת ביטוי למדא של LazyLayoutItemProvider, ולא אובייקט רגיל כמו קודם. פונקציית עומס היתר הקודמת הוצאה משימוש. (I42a5a)
  • מוסיפים TvKeyboardAlignment כדי לאפשר למפתח להגדיר את המיקום של המקלדת הווירטואלית דרך AndroidImeOptions. (Idb772)
  • הוספת rememberCarouselState כדי לזכור את CarouselState עם Saver ל-TV Compose Material. (Id7275)
  • שינוי הפרמטר scrimColor: Color לפרמטר scrimBrush:Brush כדי לאפשר למשתמשים להוסיף מעברי צבע למסך החצי שקוף. (I254d4)

גרסה ‎1.0.0-alpha08

26 ביולי 2023

androidx.tv:tv-foundation:1.0.0-alpha08 וגם androidx.tv:tv-material:1.0.0-alpha08 מופצים. גרסה ‎1.0.0-alpha08 מכילה את השמירות האלה.

תכונות חדשות

  • הוספת רכיבי Chip לחומרים של Compose for TV. ‏(I86da4)
  • מוסיפים רכיב ListItem ל-TV Compose Material. (I3f0b3)
  • הוספת רכיב DenseListItem לחומר של TV Compose. ‏(I536bf)

שינויים ב-API

  • סימנו ממשקי API של חומרים לטלוויזיה כניסיוניים. (I632e7)
  • הוספנו את TabRowScope כדי לשתף מצב מ-TabRow composable עם Tab composable ושינינו את השם של מאפייני TabColors. (Ief587)

גרסה ‎1.0.0-alpha07

‫7 ביוני 2023

androidx.tv:tv-foundation:1.0.0-alpha07 ו-androidx.tv:tv-material:1.0.0-alpha07 הושקו. גרסה ‎1.0.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • האינדיקציות של קנה המידה של הרכיבים כוללות עכשיו את האפשרות 'ללא' כדי להשבית את שינוי הגודל. (I50df5)
  • נוספה תמיכה בלחיצה ארוכה על משטחי Material, כרטיסים ולחצנים בטלוויזיה. (Id2b89)
  • הסרנו את CarouselItem ואת CarouselScope. אפשר להשיג אנימציה של תוכן בחזית בשקף באמצעות Modifier.animateEnterExit מ-AnimatedContentScope. (Ic038e)
  • הפרמטרים color ו-contentColor מוזגו לפרמטר colors עבור TV Material Surface. (Ie69eb)
  • הוספנו את RadioButton composable ב-TV Material. ‏(I08690)
  • הוספנו את Switch composable ב-TV Material. ‏(I45e29)
  • נוסף רכיב קומפוזבילי Checkbox ב-TV Material. ‏(I6a45a)
  • הוספנו משטח שלא ניתן לאינטראקציה ב-TV Material. ‏(Ic5f85)
  • ההערות יהיו פנימיות. (Ibff82)

גרסה ‎1.0.0-alpha06

‫19 באפריל 2023

androidx.tv:tv-foundation:1.0.0-alpha06 וגם androidx.tv:tv-material:1.0.0-alpha06 מופצים. גרסה ‎1.0.0-alpha06 מכילה את השמירות האלה.

תכונות חדשות

  • הוספנו הטמעות של כרטיסים ב-Material 3 שעברו אופטימיזציה לטלוויזיה.
    • כרטיס בסיסי (I5b701)
    • ClassicCard, ‏ CompactCard ו-WideClassicCard (I70471)
    • StandardCardLayout ו-WideCardLayout (I33fae)
  • הוספת הטמעות של לחצנים מסוג Material 3 שעברו אופטימיזציה לטלוויזיה.
    • כפתור בסיסי (I69c11)
    • IconButton ו-OutlinedIconButton (Ib504c)
    • WideButton (I4cecf)

שינויים ב-API

  • השמות של CarouselSlide ו-slideCount ב-Carousel שונו ל-CarouselItem ו-itemCount. (Ie554c)
  • השמות forward ו-backward ContentTransforms שונו ל-StartToEnd ו-EndToStart. (Ie554c)

תיקוני באגים

  • טיפול בלחצן 'הקודם' בלחצני החיצים כשהמיקוד הוא על NavigationDrawer. (d654f4)

גרסה ‎1.0.0-alpha05

‫22 במרץ 2023

androidx.tv:tv-foundation:1.0.0-alpha05 וגם androidx.tv:tv-material:1.0.0-alpha05 מופצים. גרסה ‎1.0.0-alpha05 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו את רכיב ה-Composable‏ Side Navigation Drawer ל-tv-material. כדי ללמוד איך להשתמש ברכיב ה-Composable הזה, אפשר לעיין בדוגמאות. (I12c08)
  • הצגת רכיב Icon composable ב-TV Material 3 (I72db9)
  • הוספנו את הקומפוזבל Surface ל-tv-material עם אינדיקציות כמו Border, ‏ Glow ו-Scale, שאפשר להשתמש בהן כדי ליצור רכיבים שמדגישים בבירור את הרכיב הממוקד במסך הטלוויזיה. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376)
  • עדכון CarouselItem ל-CarouselSlide כדי להתאים לשם הפרמטר slideCount ב-API של Carousel‏ (Ic4299)

גרסה ‎1.0.0-alpha04

‫8 בפברואר 2023

androidx.tv:tv-foundation:1.0.0-alpha04 וגם androidx.tv:tv-material:1.0.0-alpha04 מופצים. גרסה ‎1.0.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • בשורות, בעמודות ובטבלאות עצלניות, אם צריך, המיקום של ציר הסיבוב משתנה כדי לוודא שכל הפריט מוצג. (11d7e40)
  • הוספת התאמה אישית של צבעי כרטיסיות במצבים שונים. (21b2925)
  • עכשיו אפשר להוסיף לקרוסלה אנימציות מותאמות אישית לגלילה ידנית קדימה ואחורה. (431494a)

שינויים ב-API

  • שינוי השם של androidx.tv.material ל-androidx.tv.material3 ושיטוח מבנה החבילה ב-androidx.tv.material3. (I6ca52)
  • האינדיקטור בשורה Carousel Indicator הוא עכשיו משבצת שאפשר להתאים אישית באמצעות כלי הפיתוח. (268af2a)
  • שם המשתנה focusableItem שונה ל-immersiveListItem. המשתמשים יצטרכו להוסיף ידנית את משנה המשתנה focusable() או clickable() לצד immersiveListItem (5dd5078)(b/263061052)
  • השם של timeToDisplayMillis שונה ל-autoScrollDurationMillis ברכיב הקרוסלה. (431494a)
  • השימוש ב-CarouselItem מוגבל עכשיו ל-Carousel. (431494a)
  • עכשיו אפשר להשתמש ב-ContentTransforms כהגדרת אנימציה בקרוסלה במקום ב-EnterTransition וב-ExitTransitions. (431494a)
  • הוספנו PinnableContainer api שמופץ על ידי רשימות עצלות באמצעות קומפוזיציה מקומית שמאפשרת להצמיד את הפריט הנוכחי. (Ib8881, ‏ b/259274257, ‏ b/195049010)
  • נוסף נכס mainAxisItemSpacing אל TvLazyListLayoutInfo ואל TvLazyGridLayoutInfo (I37765)

תיקוני באגים

  • עדכון של tab-row כדי לוודא שהוא מטפל נכון ב-tab-count של 0 או 1. (I44009), (1c01525), (b/264018028)
  • תוקנה קריסת חיפוש המיקוד כש-TvLazyColumn מכיל TvLazyRow ריק. (e11b4fe), (b/260299091)
  • המשנה clickable פועל עכשיו עם ImmersiveList. ‪(5dd5078), (b/263061052)
  • מקש 'הקודם' מטופל עכשיו ומשמש ליציאה מקרוסלת התכנים המומלצים. (84c138c)
  • הקרוסלה לא מאבדת את המיקוד בלחיצות מהירות חוזרות על מקשים. (799489f)
  • הקרוסלה לא מאבדת את המיקוד בלחיצות ארוכות על מקשים. (b2cf37e)
  • תוקנו קריסות שמתרחשות כשמשנים את מספר השקפים בקרוסלה. (b261247)

גרסה ‎1.0.0-alpha03

‫7 בדצמבר 2022

androidx.tv:tv-foundation:1.0.0-alpha03 וגם androidx.tv:tv-material:1.0.0-alpha03 מופצים. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • TabRow זמין עכשיו כ-API ניסיוני שמאפשר למשתמשים להוסיף סרגלי ניווט עליונים לאפליקציות שלהם. בדרך כלל, במכשירי טלוויזיה, הכרטיסיות נטענות כשמתמקדים בכותרת של הכרטיסייה בשורת הכרטיסיות.
  • אינדיקטורים ספציפיים לטלוויזיה, כמו אינדיקטור קו תחתון ואינדיקטור גלולה, מוצעים כברירת מחדל. דוגמאות לשימוש אפשר למצוא ב-tv-samples

גרסה ‎1.0.0-alpha02

9 בנובמבר 2022

androidx.tv:tv-foundation:1.0.0-alpha02 וגם androidx.tv:tv-material:1.0.0-alpha02 מופצים. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

תיקוני באגים

  • שיפור הביצועים של הגלילה כשגוללים באוסף של TvLazyRows/TvLazyColumns על ידי צמצום מרחב החיפוש של המיקוד.(I723a3)

גרסה ‎1.0.0-alpha01

‫5 באוקטובר 2022

androidx.tv:tv-foundation:1.0.0-alpha01 וגם androidx.tv:tv-material:1.0.0-alpha01 מופצים. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

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

  • הוספת משנה scrollableWithPivot כדי לאפשר למאגרי גלילה לא עצלים כמו Row,‏ Column ו-Grid לגלול את התוכן כך שהפריט המודגש יישאר באותו מיקום במסך הטלוויזיה.
  • הוספת קומפוזיציות TvLazyRow,‏ TvLazyColumn, ‏ TvLazyHorizontalGrid, ‏ TvLazyVerticalGrid כדי שהגלילה של מאגר התוכן תגרום לפריט שבמוקד להישאר באותו מיקום במסך הטלוויזיה.
  • הוספת קומפוזיציה של קרוסלת תוכן מומלץ לטלוויזיה שמאפשרת למשתמש ליצור קרוסלת באנרים עם גלילה אוטומטית.
  • הוספת רכיב Immersive List שניתן להרכבה לטלוויזיה, שמאפשר למשתמש ליצור Immersive Row/Column/Grid שמשנה את הרקע על סמך הפריט ברשימה שנמצא במוקד ההתעניינות.

בעיות מוכרות

  • כשמיכל הגלילה מקבל מיקוד, הרכיב הראשון לא מקבל מיקוד כברירת מחדל.
  • התמקדות בTextField לא תמיד פותחת את המקלדת או יכולה למנוע את העברת ההתמקדות לשדות אחרים.
  • הביצועים של גלילה אנכית ב-LazyColumn שמכיל LazyRows נמוכים.