Leanback

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

لإضافة اعتمادية على 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"
}

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

Leanback Leanback-Preference Version Version 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)

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

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

• تعديل الاعتماد على RecyclerView 1.3.2 لإصلاح عُطل شائع في تطبيقات التلفزيون (I2c3a0، b/292114537)

الإصدار ‎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 Leanback-Preference الإصدار 1.2.0

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

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

• (I2c3a0، b/292114537)

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

• تعديل متطلبات 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 هذه التعديلات.

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

• تم إتاحة Leanback GridLayoutManager للجميع وإمكانية استبداله في BaseGridView. (f316b5)

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

• تم إتاحة Leanback GridLayoutManager للجميع وإمكانية استبداله في BaseGridView. (f316b5)

الإصدار 1.1.0

الإصدار ‎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)
• تغيير الحد الأدنى التلقائي لإصدار SDK من المستوى 21 لواجهة برمجة التطبيقات إلى المستوى 23 (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار 1.1.0-rc02 من Leanback

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

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

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

• تم إصلاح خطأ خلفية جزء التفاصيل. (40d8e3)

Leanback Leanback-Preference Version 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)

الإصدار 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 إلى الإصدار 3.1.0 من مكتبة Paging (882ed1)

الإصدار 1.1.0-alpha09 من Leanback-Paging

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

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

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

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

الإصدار 1.1.0-alpha08 من Leanback-Paging

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

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

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

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

الإصدار 1.1.0-alpha07 من Leanback-Paging

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 من Leanback-Paging

‫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 الجديدة

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

• تم إصلاح تعطُّل في معاملة Fragment بعد إيقاف BrowseSupportFragment
• يجب ألا يتم قص العناصر في GuidedStepSupportFragment (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، وتم إيقاف فئات fragment في إطار العمل نهائيًا.
• تستند الألوان والخطوط الآن إلى سمات مظهر إطار العمل.

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

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