Leanback

الإعلان عن التبعيات

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

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زرّ النجمة.

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.0.0 من Leanback-Grid

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

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

• تمّ إتاحة GridLayoutManager في وضع Leanback وأصبح قابلاً للاستبدال في BaseGridView. (f316b5)

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

• تمّ إتاحة GridLayoutManager في وضع Leanback وأصبح قابلاً للاستبدال في BaseGridView. (f316b5)

الإصدار 1.1.0

الإصدار 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 من ميزة "التنقّل السريع"

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

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

• عدِّل Paging-leanback إلى 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 على هذه المراجعات.

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

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

الإصدار 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 Version 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 على هذه المراجعات.

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

• يجب أن تراعي ميزة التنقّل في واجهة مستخدم المساواة في إمكانية الاستخدام سمتَي GridLayoutManager focusOutFront وfocusOutEnd. (b/161390258)

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

• حلّ مشكلة تسرُّب البيانات في GuidanceStylist.onDestroyView() (b/164841457)
• إصلاح ConcatAdapter في GridLayoutManager (b/165694295)
• leanback-tab: تحسينات على Javadoc وإعادة صياغة طفيفة للرمز البرمجي (aosp/1393383)
• إزالة طريقة setRecyclerView من واجهة برمجة التطبيقات التي تمت إضافتها عند إيقاف الطريقة نفسها نهائيًا في RecyclerView عدِّل مكتبة leanback لاستخدام طريقة addRecyclerListener API الجديدة في 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.
• تمت إضافة مظاهر تطبيق متوافقة مع واجهة Leanback من أجل تبسيط إنشاء قاعدة رموز برمجية واحدة بين الأجهزة الجوّالة والتلفزيون.

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

• تمت إضافة محوِّل استنادًا إلى asyncpagingdatadiffer لتطبيقات widgets المتوافقة مع واجهة Leanback (If0dfe).
• إضافة تخطيط علامات تبويب مخصّص ليتم استخدامه كشريط تنقّل في أعلى الشاشة في وضع 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() للسماح للتطبيق بإيقاف إخفاء/إظهار عناصر التحكّم في التشغيل تلقائيًا عند الضغط على DPAD.

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

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

الإصدار 1.1.0-alpha01

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

تم إصدار androidx.leanback:leanback 1.1.0-alpha01.

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

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

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

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

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

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

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

• تم إيقاف فئات أقسام androidx الجديدة وفئات أقسام إطار العمل نهائيًا.