Leanback

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

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

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

dependencies {
    def leanback_version = "1.2.0-alpha04"

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

    // 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-alpha04"

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

    // 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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى إلقاء نظرة على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة تصويتك إلى مشكلة حالية عن طريق بالنقر فوق زر النجمة.

إنشاء عدد جديد

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

Leanback-Grid الإصدار 1.0.0

الإصدار 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)

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

• تأكّد من التعامل مع الشبكات كشبكات من خلال خدمات a11y عن طريق ضبط اسم فئة معلومات العقدة a11y. (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)

تعديل بشأن التبعية

• عليك تعديل متطلبات إعادة التدوير إلى الإصدار 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

إصدار 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)

الإصدار 1.1 من Leanback-Paging

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

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

• يُرجى تحديث عملية نقل الصفحات خلال العودة إلى الإصدار 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-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 إلى backstack (I34483 وb/171909417)
• إصلاح تسرُّب العرض عند إرسال تفاصيل SupportFragment إلى backstack (Ifec9e وb/171909417)
• إصلاح تسرُّب العرض عند إرسال سمة AudiencesSupportFragment في تسلسل استدعاء الدوال البرمجية (I985d4، b/171909417)
• إصلاح الرسوم المتحركة للانتقال في الخلفية GuidedStepSupportFragment (I86d15، b/173647688)
• إصلاح UnknownArgumentException عند استعادة GuidedStepSupportFragment (Ic829f وb/172000115)
• إصلاح GridLayoutManager NullPointerException في 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 الاستبدال مع. (I6e2dd)

الإصدار 1.1.0-alpha05

1 تشرين الأول (أكتوبر) 2020

تم طرح androidx.leanback:leanback-*:1.1.0-alpha05. يحتوي الإصدار 1.1.0-alpha05 على هذه عمليات التنفيذ.

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

• السماح للتنقّل A11Y باحترام سمتَي GridLayoutManager activityOutFront و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 for 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-Preference Version 1.1.0-alpha03 يحتوي على عمليات التنفيذ التالية.

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

• يوفّر BaseGridView الآن سرعات تمرير مخصّصة (aosp/952718).
• تم جعل عنصر الخطوات الإرشادي أكثر سهولة (aosp/1167964)
• تم الكشف عن BaseGridView OnLayoutCompleteListener حتى تتمكن التطبيقات من إجراء عمليات تحويل العرض بعد تمرير التنسيق. (aosp/1164409)

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

• تمت إضافة واجهة برمجة تطبيقات جديدة للسماح بسرعات التمرير المخصّصة في BaseGridView (aosp/952718).
• تمت إضافة واجهة برمجة تطبيقات جديدة لإضافة 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 وعمليات تنفيذ leanback.

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

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

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

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

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

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

الإصدار 1.1.0-alpha01

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

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

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

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

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

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

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

• تم إصلاح تعطُّل معاملة مجزّأة بعد إيقاف 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 الجديدة، وفئات أجزاء إطار العمل.