Leanback

במקום הארטיפקט הזה, צריך להשתמש ב-Compose for TV.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
12 במרץ 2025 1.0.0 1.1.0-rc02 1.2.0-beta01 -

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

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

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

מגניב

dependencies {
    def leanback_version = "1.2.0-beta01"

    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-beta01"

    // 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-beta01"
}

Kotlin

dependencies {
    val leanback_version = "1.2.0-beta01"

    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-beta01")

    // 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-beta01")
}

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

משוב

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

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

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

Leanback-Grid גרסה 1.0.0

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

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

Leanback גרסה 1.1.0-rc02

21 ביולי 2021

androidx.leanback:leanback:1.1.0-rc02 משוחרר. גרסה 1.1.0-rc02 כוללת את השמירות האלה.

תיקוני באגים

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

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

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

Leanback-Paging גרסה 1.1.0-alpha09

17 בנובמבר 2021

androidx.leanback:leanback-paging:1.1.0-alpha09 משוחרר. גרסה 1.1.0-alpha09 מכילה את ההצהרות האלה.

תיקוני באגים

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

Leanback-Paging גרסה 1.1.0-alpha08

21 ביולי 2021

androidx.leanback:leanback-paging:1.1.0-alpha08 משוחרר. גרסה 1.1.0-alpha08 מכילה את ההצהרות האלה.

שינויים ב-API

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

Leanback-Paging גרסה 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)
  • תיקון GridLayoutManager NullPointerException ב-findContainingItemView() כש-clearFocus() (Id0e42)

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

תכונות חדשות

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

תיקוני באגים

  • תיקון של דליפת View ב-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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

  • LeanbackTabLayout מספק את הניווט העליון (בדרך כלל מוצג אופקית בחלק העליון של האפליקציה) בחוויית הגלישה.
  • הוספת תמיכה בחלוקה לדפים ל-Leanback מפשטת את הוספת התמיכה בחלוקה לדפים ל-RecyclerView.Adapter.
  • הוספנו נושאים של תאימות לאפליקציות ל-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)
  • תוקנה קריסה של חריגה מ-stack בווידג'ט הבורר כשהמיקוד משתנה (aosp/1168473)

שינויים ביחסי התלות

  • Leanback-preference: pinned the dependency of androidx.preference to 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 ושמירות leanback-preference.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

גרסה 1.1.0-alpha01

30 בינואר 2019

androidx.leanback:leanback 1.1.0-alpha01 משוחרר.

תכונות חדשות

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

שינויים ב-API

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

תיקוני באגים

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

androidx.leanback-preference 1.1.0-alpha01 משוחרר.

תכונות חדשות

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

שינויים ב-API

  • הכיתות החדשות של קטעי קוד ב-androidx, והכיתות של קטעי הקוד במסגרת הוצאו משימוש.