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-Preferred

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

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

تعديل التبعية

  • تحديث متطلّب إعادة التدوير إلى 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)

الإصدار 1.1.0-rc01 من Leanback Leanback-Preferences

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-Page

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

تم إطلاق "androidx.leanback:leanback-paging:1.1.0-alpha09". يحتوي الإصدار 1.1.0-alpha09 على هذه الالتزامات.

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

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

الإصدار 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-Preferences 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)
  • إصلاح تسرّب طريقة العرض عند دفع DetailsSupportFragment إلى الحزمة الخلفية (Ifec9e ، b/171909417)
  • إصلاح تسرّب طريقة العرض عند دفع ROWSsSupportFragment إلى الحزمة الخلفية (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 على هذه الالتزامات.

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

  • تمت إزالة واجهات برمجة التطبيقات dataEfFlow / dataRefresh Listener لأنّ هذه الواجهات متكررة عن تحديثات uploadStateFlow / Listener. بالنسبة إلى عملية النقل هذه، يكون مكافئ uploadStateFlow على النحو التالي:

    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 voiceOutFront وFocusOutEnd. (b/161390258)

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

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

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

  • تمت إضافة المحول استنادًا إلى متغير البيانات غير المتزامن مع أدوات 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 OnLayoutComplete Listener حتى تتمكن التطبيقات من إجراء عمليات تحويل العرض بعد تمرير التخطيط. (aosp/1164409)

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

  • تمت إضافة واجهة برمجة تطبيقات جديدة للسماح بسرعات التمرير المخصّصة في BaseGridView (aosp/952718)
  • تمت إضافة واجهة برمجة تطبيقات جديدة لإضافة OnLayoutComplete Listener في 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 بمشاركة عناصر عرض الشاشة مع عناصر أخرى، ما سيؤدي إلى تحسين أداء واجهة المستخدم متعددة علامات التبويب.

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

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