Leanback

אפשר להשתמש ב-Compose for TV במקום בארטיפקט הזה.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫19 במאי 2026 ‫1.2.0 - - ‎1.3.0-alpha01

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

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

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

מגניב

dependencies {
    def leanback_version = "1.3.0-alpha01"

    implementation "androidx.leanback:leanback:$leanback_version"

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation "androidx.leanback:leanback-preference:$leanback_version"

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation "androidx.leanback:leanback-paging:1.1.0"

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation "androidx.leanback:leanback-tab:1.1.0"
}

Kotlin

dependencies {
    val leanback_version = "1.3.0-alpha01"

    implementation("androidx.leanback:leanback:$leanback_version")

    // leanback-preference is an add-on that provides a settings UI for TV apps.
    implementation("androidx.leanback:leanback-preference:$leanback_version")

    // leanback-paging is an add-on that simplifies adding paging support to a RecyclerView Adapter.
    implementation("androidx.leanback:leanback-paging:1.1.0")

    // leanback-tab is an add-on that provides customized TabLayout to be used as the top navigation bar.
    implementation("androidx.leanback:leanback-tab:1.1.0")
}

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

משוב

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

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

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

Leanback-Grid Version 1.1

גרסה ‎1.1.0-alpha01

‫19 במאי 2026

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

שינויים ב-API

  • מוסיפים את setSelectedPositionToUnalignedChild ו-setSelectedPositionToAlignedChild כדי לשנות את המיקום שנבחר בלי להפעיל גלילה. ‫(If53ab, ‏ b/499067714)
  • מספקת setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) כדי לתמוך בהצמדה במצב מגע. (I55fbc)
  • תמיכה ב-SpanSizeLookup עם אפשרות להשתמש בכל המרווחים ואזור הריפוד. (I7f87c)
  • חשיפה של getNumColumns() ושל getNumRows() (Icd8c0, b/138276997)

תיקוני באגים

גרסה 1.3 של Leanback Leanback-Preference

גרסה ‎1.3.0-alpha01

‫19 במאי 2026

‫androidx.leanback:leanback:1.3.0-alpha01 מופץ. גרסה ‎1.3.0-alpha01 מכילה את השמירות האלה.

שינויים ב-API

  • תמיכה ב-SpanSizeLookup עם אפשרות להשתמש בכל המרווחים ואזור הריפוד. (I7f87c)
  • חשיפה של getNumColumns() ושל getNumRows() (Icd8c0, b/138276997)
  • הסרה של הערות @RequiresApi(21) שיצאו משימוש (Ic4792)

תיקוני באגים

Leanback-Grid Version 1.0.0

גרסה 1.0.0

‫23 באפריל 2025

‫androidx.leanback:leanback-grid:1.0.0 מופץ. הגרסה לא מכילה שינויים, היא רק מועברת לגרסה יציבה.

גרסה ‎1.0.0-rc01

‫9 באפריל 2025

‫androidx.leanback:leanback-grid:1.0.0-rc01 מופץ. אין כאן קומיטים משמעותיים, והספרייה רק מועברת למצב יציב.

גרסה ‎1.0.0-alpha03

‫15 בנובמבר 2023

‫androidx.leanback:leanback-grid:1.0.0-alpha03 מופץ. גרסה ‎1.0.0-alpha03 מכילה את השמירות האלה.

עדכונים של יחסי תלות

גרסה ‎1.0.0-alpha02

‫6 בספטמבר 2023

‫androidx.leanback:leanback-grid:1.0.0-alpha02 מופץ. גרסה ‎1.0.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

  • הגדרנו את setFocusOutAllowed כמאפיין ציבורי כדי לאפשר הגדרה פרוגרמטית של מאפייני היציאה מהמיקוד. (Iebd99)

תיקוני באגים

  • כדי לוודא שרשתות נחשבות לרשתות על ידי שירותי נגישות, צריך להגדיר שם מחלקה של מידע על צומת נגישות. (I12812)
  • הוספת צליל ניווט חסר כשעוברים לגלילה חלקה. (f49767)

גרסה 1.0.0-alpha01

17 בנובמבר 2021

‫androidx.leanback:leanback-grid:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הועברו המחלקות או הממשקים הבאים מ-leanback לספרייה החדשה leanback-grid: BaseGridView, ‏ FacetProvider, ‏ FacetProviderAdapter, ‏ GridLayoutManager, ‏ HorizontalGridView, ‏ ItemAlignmentFacet, ‏ OnChildLaidOutListener, ‏ OnChildSelectedListener, ‏ OnChildViewHolderSelectedListener, ‏ VerticalGridView, ‏ ViewHolderTask, ‏ Visibility. השינוי הזה שומר על תאימות בינארית. כל מי שרוצה להשתמש רק ברכיבי תצוגת משבצות של Leanback יכול להשתמש ישירות ב-leanback-grid כתלות. (If1e49)

גרסה 1.2.0 של Leanback Leanback-Preference

גרסה 1.2.0

‫23 באפריל 2025

‫androidx.leanback:leanback:1.2.0 וגם androidx.leanback:leanback-preference:1.2.0 מופצים. הגרסה לא מכילה שינויים, היא רק מועברת לגרסה יציבה.

גרסה ‎1.2.0-rc01

‫9 באפריל 2025

‫androidx.leanback:leanback:1.2.0-rc01 וגם androidx.leanback:leanback-preference:1.2.0-rc01 מופצים. אין כאן קומיטים משמעותיים, והספרייה רק מועברת למצב יציב.

גרסה ‎1.2.0-alpha04

‫15 בנובמבר 2023

‫androidx.leanback:leanback:1.2.0-alpha04 וגם androidx.leanback:leanback-preference:1.2.0-alpha04 מופצים. גרסה ‎1.2.0-alpha04 מכילה את השמירות האלה.

תיקוני באגים

עדכון תלות

  • עדכון הדרישה של recyclerview לגרסה 1.3.2 כדי לתקן קריסה נפוצה באפליקציות לטלוויזיה

גרסה ‎1.2.0-alpha03

‫6 בספטמבר 2023

‫androidx.leanback:leanback:1.2.0-alpha03 וגם androidx.leanback:leanback-preference:1.2.0-alpha03 מופצים. גרסה ‎1.2.0-alpha03 מכילה את השמירות האלה.

שינויים ב-API

  • הוספנו את GuidedActionAppCompatEditText כדי לשפר את התמיכה בערכת הנושא AppCompat. (ab7cf1, dc954d)

גרסה ‎1.2.0-alpha02

17 בנובמבר 2021

‫androidx.leanback:leanback:1.2.0-alpha02 וגם androidx.leanback:leanback-preference:1.2.0-alpha02 מופצים. גרסה ‎1.2.0-alpha02 מכילה את השמירות האלה.

תכונות חדשות

  • הועברו המחלקות או הממשקים הבאים מ-leanback לספרייה החדשה leanback-grid: BaseGridView, ‏ FacetProvider, ‏ FacetProviderAdapter, ‏ GridLayoutManager, ‏ HorizontalGridView, ‏ ItemAlignmentFacet, ‏ OnChildLaidOutListener, ‏ OnChildSelectedListener, ‏ OnChildViewHolderSelectedListener, ‏ VerticalGridView, ‏ ViewHolderTask, ‏ Visibility. השינוי הזה שומר על תאימות בינארית. כל מי שרוצה להשתמש רק ברכיבי תצוגת משבצות של Leanback יכול להשתמש ישירות ב-leanback-grid כתלות. (If1e49)

גרסה ‎1.2.0-alpha01

21 ביולי 2021

‫androidx.leanback:leanback:1.2.0-alpha01 וגם androidx.leanback:leanback-preference:1.2.0-alpha01 מופצים. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

  • הפכנו את GridLayoutManager ב-BaseGridView לגלוי לכולם ולניתן להחלפה. (f316b5)

שינויים ב-API

  • הפכנו את GridLayoutManager ב-BaseGridView לגלוי לכולם ולניתן להחלפה. (f316b5)

גרסה 1.1.0

גרסה ‎1.1.0-alpha01

‫19 במאי 2026

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

שינויים ב-API

  • מוסיפים setSelectedPositionToUnalignedChild ו-setSelectedPositionToAlignedChild כדי לשנות את המיקום שנבחר בלי להפעיל גלילה. ‫(If53ab, ‏ b/499067714)
  • מספקת את הפונקציה setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP)‎ כדי לתמוך בהצמדה במצב מגע. (I55fbc)
  • תמיכה ב-SpanSizeLookup עם אפשרות לתפוס את כל הטווחים ואזור הריפוד. (I7f87c)
  • Expose getNumColumns() and getNumRows() (Icd8c0, b/138276997)

תיקוני באגים

גרסה ‎1.1.0-rc02 של Leanback

21 ביולי 2021

‫androidx.leanback:leanback:1.1.0-rc02 מופץ. גרסה ‎1.1.0-rc02 מכילה את השמירות האלה.

תיקוני באגים

  • תוקן באג ברקע של פרטי הפרגמנט. (40d8e3)

גרסה 1.1.0-rc01 של Leanback Leanback-Preference

‫7 באפריל 2021

‫androidx.leanback:leanback:1.1.0-rc01 וגם androidx.leanback:leanback-preference:1.1.0-rc01 מופצים. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

  • תוקנו דליפות של תצוגות ב-SearchSupportFragment() (6c47a1, b/171909417)
  • הוספנו אפשרות להשתמש בזיהוי דיבור ב-SearchSupportFragment (4ff949,‏ b/169936953)

גרסה 1.1 של Leanback-Paging

גרסה 1.1.0

‫23 באפריל 2025

‫androidx.leanback:leanback-paging:1.1.0 וגם androidx.leanback:leanback-tab:1.1.0 מופצים. הגרסה לא מכילה שינויים, היא רק מועברת לגרסה יציבה.

גרסה ‎1.1.0-rc01

‫9 באפריל 2025

‫androidx.leanback:leanback-paging:1.1.0-rc01 וגם androidx.leanback:leanback-tab:1.1.0-rc01 מופצים. אין כאן קומיטים משמעותיים, והספרייה רק מועברת למצב יציב.

גרסה ‎1.1.0-alpha11

‫15 בנובמבר 2023

הגרסה androidx.leanback:leanback-paging:1.1.0-alpha11 יוצאת ללא שינויים. גרסה ‎1.1.0-alpha11 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha10

‫6 בספטמבר 2023

‫androidx.leanback:leanback-paging:1.1.0-alpha10 מופץ. גרסה ‎1.1.0-alpha10 מכילה את השמירות האלה.

תכונות חדשות

  • עדכון של leanback-paging לגרסה Paging 3.1.0. (882ed1)

גרסה ‎1.1.0-alpha09 של Leanback-Paging

17 בנובמבר 2021

‫androidx.leanback:leanback-paging:1.1.0-alpha09 מופץ. גרסה ‎1.1.0-alpha09 מכילה את השמירות האלה.

תיקוני באגים

  • העדכון כולל שימוש בממשקי ה-API העדכניים ביותר של חלוקה לדפים.

גרסה ‎1.1.0-alpha08 של Leanback-Paging

21 ביולי 2021

‫androidx.leanback:leanback-paging:1.1.0-alpha08 מופץ. גרסה ‎1.1.0-alpha08 מכילה את השמירות האלה.

שינויים ב-API

  • נוספו ממשקי API‏ .peek() ו-.snapshot() ל-PagingDataAdapter, שמאפשרים לבדוק את הנתונים שמוצגים בלי להפעיל אחזור של דף. (Ic8917)

גרסה ‎1.1.0-alpha07 של Leanback-Paging

‫13 בינואר 2021

‫androidx.leanback:leanback-paging:1.1.0-alpha07 מופץ. גרסה ‎1.1.0-alpha07 מכילה את השמירות האלה.

שינויים ב-API

  • המאפיינים הנוחים CombinedLoadStates.refresh, CombinedLoadStates.prepend ו-CombinedLoadStates.append עודכנו כך שהמעבר מ-Loading ל-NotLoading יתבצע רק אחרי שמצבי הטעינה של המתווך והמקור יהיו NotLoading, כדי לוודא שהעדכון מרחוק הוחל. (I65619)

‫Leanback Leanback-Preference Leanback-Tab גרסה ‎1.1.0-beta01

2 בדצמבר 2020

האפליקציות androidx.leanback:leanback:1.1.0-beta01, androidx.leanback:leanback-preference:1.1.0-beta01 וגם androidx.leanback:leanback-tab:1.1.0-beta01 מושקות. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

תיקוני באגים

  • תיקון דליפת תצוגה כשמעבירים VerticalGridSupportFragment אל backstack ‏ (Iaac69, ‏ b/171909417)
  • תיקון של דליפת תצוגה כשמעבירים BrowseSupportFragment אל backstack ‏ (I34483, ‏ b/171909417)
  • תיקון של דליפת תצוגה כשמעבירים את DetailsSupportFragment אל backstack ‏ (Ifec9e, ‏ b/171909417)
  • תיקון של דליפת תצוגה כשמעבירים את RowsSupportFragment אל backstack ‏ (I985d4, ‏ b/171909417)
  • תיקון אנימציית המעבר ברקע של GuidedStepSupportFragment. (I86d15, b/173647688)
  • תיקון של IllegalArgumentException בשחזור GuidedStepSupportFragment ‏ (Ic829f, ‏ b/172000115)
  • תיקון של NullPointerException ב-GridLayoutManager ב-findContainingItemView() כשמפעילים את clearFocus() (Id0e42)

גרסה ‎1.1.0-alpha06 של Leanback-Paging

2 בדצמבר 2020

‫androidx.leanback:leanback-paging:1.1.0-alpha06 מופץ. גרסה ‎1.1.0-alpha06 מכילה את השמירות האלה.

שינויים ב-API

  • ממשקי ה-API ‏dataRefreshFlow / dataRefreshListener הוסרו כי הם מיותרים עם העדכונים של loadStateFlow / Listener. למי שמבצע העברה, המקבילה ל-loadStateFlow היא:

    loadStateFlow.distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is NotLoading }

    (Ib5570, ‏ b/173530908)

  • הוצאה מלאה משימוש של השיטות dataRefreshFlow / Listener עם סעיף replaceWith. (I6e2dd)

גרסה ‎1.1.0-alpha05

‫1 באוקטובר 2020

‫androidx.leanback:leanback-*:1.1.0-alpha05 מופץ. גרסה ‎1.1.0-alpha05 מכילה את השמירות האלה.

תכונות חדשות

  • אפשר לניווט של A11Y להתחשב במאפיינים focusOutFront ו-focusOutEnd של GridLayoutManager. (b/161390258)

תיקוני באגים

  • תיקון דליפת מידע ב-GuidanceStylist.onDestroyView() (b/164841457)
  • תיקון של ConcatAdapter ב-GridLayoutManager ‏ (b/165694295)
  • leanback-tab: שיפורים ב-Javadoc ושינוי קל של מבנה הקוד (aosp/1393383)
  • הסרה של שיטת setRecyclerView מ-API שנוספה כשאותה שיטה הוצאה משימוש ב-RecyclerView. מעדכנים את leanback lib כדי להשתמש בשיטת ה-API החדשה addRecyclerListener של RecyclerView. (I14798)

גרסה ‎1.1.0-alpha04

‫11 באוגוסט 2020

הגרסאות androidx.leanback:leanback:1.1.0-alpha04, androidx.leanback:leanback-paging:1.1.0-alpha04, androidx.leanback:leanback-preference:1.1.0-alpha04 ו-androidx.leanback:leanback-tab:1.1.0-alpha04 יוצאות לשוק. גרסה ‎1.1.0-alpha04 מכילה את השמירות האלה.

תכונות חדשות

  • ה-LeanbackTabLayout מספק את הניווט העליון (בדרך כלל מוצג אופקית בחלק העליון של האפליקציה) בחוויית הגלישה.
  • הספרייה Paging for Leanback מפשטת את הוספת התמיכה בהחלפת דפים ל-RecyclerView.Adapter.
  • נוספו ערכות נושא של appcompat ל-Leanback שיפשטו את היצירה של בסיס קוד יחיד בין נייד לטלוויזיה.

שינויים ב-API

  • נוסף מתאם שמבוסס על asyncpagingdatadiffer לווידג'טים של leanback (If0dfe)
  • הוספת TabLayout בהתאמה אישית לשימוש כסרגל הניווט העליון ב-Leanback (I1e304)

גרסה ‎1.1.0-alpha03

18 בדצמבר 2019

‫androidx.leanback:leanback:1.1.0-alpha03 וגם androidx.leanback:leanback-preference:1.1.0-alpha03 מופצים. ‫Leanback גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה ו-Leanback-Preference גרסה ‎1.1.0-alpha03 מכילה את השמירות האלה.

תכונות חדשות

  • ‫BaseGridView תומך עכשיו במהירויות גלילה מותאמות אישית (aosp/952718)
  • שיפור הנוחות של פריט צעד מונחה (aosp/1167964)
  • הוספנו את BaseGridView OnLayoutCompleteListener כדי שאפליקציות יוכלו לבצע טרנספורמציות של View אחרי מעבר הפריסה. (aosp/1164409)

שינויים ב-API

  • נוסף API חדש שמאפשר מהירויות גלילה מותאמות אישית ב-BaseGridView (aosp/952718)
  • נוסף API חדש להוספת OnLayoutCompleteListener ב-BaseGridView (aosp/1164409)

תיקוני באגים

  • תוקן באג שגרם לכך שהתאמת הפריסה המהירה לא עדכנה את היישור של רכיב צאצא. (aosp/1122745)
  • תוקנה קריסת גלישת מחסנית בווידג'ט של הכלי לבחירת קבצים כשמשנים את המיקוד (aosp/1168473)

שינויים בתלות

  • העדפה של Leanback: הצמדת התלות של androidx.preference ל-1.1.0 (aosp/1181902)

גרסה ‎1.1.0-alpha02

‫7 במאי 2019

‫androidx.leanback:leanback:1.1.0-alpha02 וגם androidx.leanback:leanback-preference:1.1.0-alpha02 מופצים. השמירות שנכללות בגרסה הזו זמינות ב-leanback commits וב-leanback-preference commits.

תכונות חדשות

  • עכשיו אפשר לשתף ViewHolders עם RowsSupportFragments אחרים, מה שישפר את הביצועים בממשק משתמש עם כמה כרטיסיות.

שינויים ב-API

  • נוסף PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() כדי לאפשר לאפליקציה להשבית את ההסתרה או ההצגה האוטומטית של אמצעי הבקרה להפעלה כשלוחצים על מקשי החיצים.

תיקוני באגים

  • תוקנה בעיה בערכת הנושא של Leanback-preference Fragments בעקבות שינוי בספריית ההעדפות.
  • תיקון באג בניווט כשלוחצים על המקש 'הקודם' ב-SearchEditText

גרסה ‎1.1.0-alpha01

30 בינואר 2019

‫androidx.leanback:leanback 1.1.0-alpha01 מופץ.

תכונות חדשות

  • נוסף הווידג'ט PinPicker.
  • האפשרות לחתוך את המתאר מושבתת עכשיו כברירת מחדל במכשירים עם זיכרון RAM נמוך.
  • התנהגות מותרת של הצגה/הסתרה של רכיבי בקרה מותאמים אישית ב-PlaybackSupportFragment (b/122918400)

שינויים ב-API

  • הוצאנו משימוש את קטעי המסגרת.
  • כיתה חדשה של PinPicker.

תיקוני באגים

  • תוקנה קריסה של טרנזקציית פרגמנט אחרי עצירה של BrowseSupportFragment
  • GuidedStepSupportFragment should not clip items in VerticalGridView (aosp/787396)
  • הפונקציות onCreateActionsStylist() ו-onCreateGuidanceStylist() הועברו מהבונה אל GuidedSupportFragment.onCreate() (aosp/787397)
  • תוקן באג שגרם לכך ש-SearchSupportFragment לא הצליח להתמקד בקטע התוצאות. (aosp/798833)
  • תוקן באג בגלילה ב-VerticalGridView וב-HorizontalGridView (aosp/858809)

‫androidx.leanback-preference 1.1.0-alpha01 מופץ.

תכונות חדשות

  • נוספו מחלקות androidx fragment, מחלקות framework fragment הוצאו משימוש.
  • הצבעים והגופנים מבוססים עכשיו על מאפייני העיצוב של המסגרת.

שינויים ב-API

  • נוספו מחלקות חדשות של androidx fragment, ומחלקות של framework fragment הוצאו משימוש.