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

גרסה 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.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)

Leanback

גרסה 1.3

גרסה ‎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)

תיקוני באגים

גרסה 1.1

גרסה ‎1.1.0-rc02

21 ביולי 2021

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

תיקוני באגים

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

Leanback-Preference

גרסה 1.2

גרסה 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 של leanback לגלוי לכולם ולניתן להחלפה ב-BaseGridView. (f316b5)

שינויים ב-API

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

גרסה 1.1

גרסה ‎1.1.0-rc01

‫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)

Leanback-Paging

גרסה 1.1

גרסה 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

17 בנובמבר 2021

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

תיקוני באגים

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

גרסה ‎1.1.0-alpha08

21 ביולי 2021

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

שינויים ב-API

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

גרסה ‎1.1.0-alpha07

‫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

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

תכונות חדשות

  • אפשר לנווט באמצעות מקשי החיצים בהתאם למאפיינים 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 מופצים. גרסה ‎1.1.0-alpha03 של Leanback מכילה את השמירות האלה וגרסה ‎1.1.0-alpha03 של Leanback-Preference מכילה את השמירות האלה.

תכונות חדשות

  • ‫BaseGridView תומך עכשיו במהירויות גלילה מותאמות אישית (aosp/952718)
  • שיפור המגע בפריט של צעד מונחה (aosp/1167964)
  • הוספנו את BaseGridView OnLayoutCompleteListener כדי שאפליקציות יוכלו לבצע טרנספורמציות של תצוגה אחרי מעבר הפריסה. (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 נמוך.
  • התאפשרה התאמה אישית של התנהגות ההצגה/ההסתרה של רכיבי ה-UI של 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 הוצאו משימוש.