Leanback

اكتب تطبيقات لأجهزة Android TV باستخدام تطبيقات مصغّرة متوافقة مع لوحة التحكّم وأجزاء النماذج.
آخر تعديل الإصدار المستقر إصدار مرشح الإصدار التجريبي الإصدار الأولي
15 تشرين الثاني (نوفمبر) 2023 1.0.0 1.1.0-rc02 - 1.2.0-alpha04

تعريف التبعيات

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

Kotlin

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

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

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

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

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

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

  • تأكّد من التعامل مع الشبكات على أنّها شبكات من خلال خدمات 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)

الإصدار 1.2.0 من Leanback Leanback-Preferences

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

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

  • تم جعل leanback GridLayoutManager عامة وقابلة للتبادل في BaseGridView. (f316b5)

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

  • تم جعل leanback GridLayoutManager عامة وقابلة للتبادل في 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-Preferences الإصدار 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-Page

الإصدار 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 إلى الإصدار 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-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 إلى الحزمة الخلفية (I34483، b/171909417)
  • إصلاح تسرّب طرق العرض عند الضغط على Details SupportFragment على Backstack (Ifec9e، b/171909417)
  • إصلاح تسرّب طرق العرض عند دفع RowsSupportFragment إلى الحزمة الخلفية (I985d4، b/171909417)
  • إصلاح الصورة المتحركة التي تظهر عند الانتقال في الخلفية في GuidedStepSupportFragment (I86d15، b/173647688)
  • إصلاح legalArgumentException عند استعادة 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 على هذه الالتزامات.

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

  • تمت إزالة واجهات برمجة التطبيقات dataتحديثFlow / dataEfListener لأنها متكررة مع تحديثات uploadStateFlow / 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 بالالتزام بسمتي GridLayoutManager sourceFrontFront و التاليsourceOutEnd. (b/161390258)

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

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

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

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

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

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

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

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

الإصدار 1.1.0-alpha01

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

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

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

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

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

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

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

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

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

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

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

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

  • تم إيقاف فئات أجزاء androidx الجديدة وفئات أجزاء إطار العمل.