Leanback

استخدِم Compose لـ Android TV بدلاً من هذا العنصر.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫19 مايو 2026 1.2.0 - - 1.3.0-alpha01

تحديد الاعتماديات

لإضافة اعتمادية على Leanback، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

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

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات الإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • أضِف setSelectedPositionToUnalignedChild وsetSelectedPositionToAlignedChild لتغيير الموضع المحدّد بدون بدء التمرير. (If53ab، b/499067714)
  • توفّر setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) لدعم المحاذاة في وضع اللمس. (I55fbc)
  • تتيح السمة SpanSizeLookup إمكانية شغل جميع الفواصل ومساحة الحشو. (I7f87c)
  • الكشف عن getNumColumns() وgetNumRows() (Icd8c0، b/138276997)

إصلاح الأخطاء

  • إصلاح مشكلة تسريب طرق العرض الفرعية بعد إعادة ضبط المحوّل (I636a0)
  • تغيير القيمة التلقائية minSdk من المستوى 21 لواجهة برمجة التطبيقات إلى المستوى 23 (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إتاحة 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تتيح السمة SpanSizeLookup إمكانية شغل جميع الفواصل ومساحة الحشو. (I7f87c)
  • الكشف عن getNumColumns() وgetNumRows() (Icd8c0، b/138276997)
  • إزالة التعليقات التوضيحية القديمة @RequiresApi(21) (Ic4792)

إصلاح الأخطاء

  • إصلاح مشكلة تسريب طرق العرض الفرعية بعد إعادة ضبط المحوّل (I636a0)
  • تغيير القيمة التلقائية minSdk من المستوى 21 لواجهة برمجة التطبيقات إلى المستوى 23 (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار 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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة 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)

تغييرات واجهة برمجة التطبيقات

  • تم إتاحة GridLayoutManager للجميع وإمكانية استبداله في 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 إلى الإصدار 3.1.0 من مكتبة Paging (882ed1)

الإصدار ‎1.1.0-alpha09

17 تشرين الثاني (نوفمبر) 2021

تم طرح androidx.leanback:leanback-paging:1.1.0-alpha09. يتضمّن الإصدار 1.1.0-alpha09 هذه التعديلات.

إصلاح الأخطاء

  • تم تعديلها لاستخدام أحدث واجهات برمجة تطبيقات التقسيم إلى صفحات.

الإصدار ‎1.1.0-alpha08

‫21 تموز (يوليو) 2021

تم طرح androidx.leanback:leanback-paging:1.1.0-alpha08. يتضمّن الإصدار 1.1.0-alpha08 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة واجهتَي برمجة التطبيقات .peek() و.snapshot() إلى PagingDataAdapter، ما يتيح فحص البيانات المعروضة بدون بدء عملية جلب الصفحة. (Ic8917)

الإصدار ‎1.1.0-alpha07

13 كانون الثاني (يناير) 2021

تم طرح androidx.leanback:leanback-paging:1.1.0-alpha07. يتضمّن الإصدار 1.1.0-alpha07 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تم تعديل خصائص الراحة، 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 إلى سجلّ الرجوع (Iaac69، b/171909417)
  • إصلاح تسرب العرض عند إضافة BrowseSupportFragment إلى سجلّ الرجوع (I34483، b/171909417)
  • إصلاح مشكلة تسرُّب عرض عند إرسال DetailsSupportFragment إلى حزمة الخلف (Ifec9e، b/171909417)
  • إصلاح مشكلة تسرُّب العرض عند نقل RowsSupportFragment إلى سجلّ الرجوع (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 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمت إزالة واجهات برمجة التطبيقات 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 من واجهة برمجة التطبيقات التي تمت إضافتها عند إيقاف الطريقة نفسها نهائيًا في RecyclerView تعديل مكتبة leanback لاستخدام طريقة 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 شريط التنقل العلوي (يتم عرضه عادةً أفقيًا في أعلى التطبيق) في تجربة التصفّح.
  • تسهّل عملية التقسيم إلى صفحات في Leanback إضافة إمكانية التقسيم إلى صفحات إلى RecyclerView.Adapter.
  • تمت إضافة سمات appcompat لـ Leanback من شأنها تبسيط عملية إنشاء قاعدة رموز برمجية واحدة بين الأجهزة الجوّالة والتلفزيون.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة أداة ربط استنادًا إلى 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)

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة واجهة برمجة تطبيقات جديدة للسماح بسرعات التمرير المخصّصة في BaseGridView (aosp/952718)
  • تمت إضافة واجهة برمجة تطبيقات جديدة لإضافة OnLayoutCompleteListener في BaseGridView (aosp/1164409)

إصلاح الأخطاء

  • تم إصلاح الخطأ الذي لا يتم فيه تعديل محاذاة العنصر الفرعي عند إجراء تمرير سريع للتصميم. (aosp/1122745)
  • تم إصلاح عُطل تجاوز سعة التخزين المؤقت في أداة الاختيار عند تغيير التركيز (aosp/1168473)

التغييرات في الاعتماديات

  • Leanback-preference: تم تثبيت تبعية 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 وتعديلات leanback-preference.

الميزات الجديدة

  • يُسمح الآن لـ RowsSupportFragment بمشاركة ViewHolders مع RowsSupportFragments أخرى، ما يؤدي إلى تحسين الأداء لواجهة مستخدم ذات علامات تبويب متعددة.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() للسماح للتطبيق بإيقاف ميزة الإخفاء التلقائي لعناصر التحكّم في التشغيل أو تفعيلها عند الضغط على لوحة مفاتيح الاتجاهات.

إصلاح الأخطاء

  • تم إصلاح مشكلة في مظهر leanback-preference Fragments بسبب تغيير في مكتبة الإعدادات المفضّلة.
  • إصلاح خطأ التنقّل عند الضغط على مفتاح الرجوع في SearchEditText

الإصدار ‎1.1.0-alpha01

30 من كانون الثاني (يناير) 2019

تم طرح androidx.leanback:leanback 1.1.0-alpha01.

الميزات الجديدة

  • تمت إضافة تطبيق PinPicker المصغّر.
  • تم الآن إيقاف ميزة "اقتصاص المخطط التفصيلي" تلقائيًا على الأجهزة ذات ذاكرة الوصول العشوائي المنخفضة.
  • السماح بعرض/إخفاء عناصر التحكّم في PlaybackSupportFragment المخصّص (b/122918400)

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف أجزاء إطار العمل نهائيًا.
  • فئة PinPicker الجديدة

إصلاح الأخطاء

  • تم إصلاح عُطل في معاملة جزء من الصفحة بعد إيقاف BrowseSupportFragment
  • يجب ألا يتم قص العناصر في GuidedStepSupportFragment (aosp/787396)VerticalGridView
  • تم نقل onCreateActionsStylist() وonCreateGuidanceStylist() من الدالة الإنشائية إلى GuidedSupportFragment.onCreate() (aosp/787397)
  • تم إصلاح الخطأ الذي تسبَّب في عدم تركيز SearchSupportFragment على جزء النتائج. (aosp/798833)
  • تم إصلاح خطأ في التمرير في VerticalGridView وHorizontalGridView (aosp/858809)

تم طرح androidx.leanback-preference 1.1.0-alpha01.

الميزات الجديدة

  • تمت إضافة فئات androidx fragment، وتم إيقاف فئات fragment في إطار العمل نهائيًا.
  • تستند الألوان والخطوط الآن إلى سمات مظهر إطار العمل.

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف فئات androidx fragment وفئات fragment في إطار العمل نهائيًا.