لاغر

به جای این مصنوع، از «نوشتن برای تلویزیون» استفاده کنید.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۱۹ مه ۲۰۲۶ ۱.۲.۰ - - ۱.۳.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن وابستگی به Leanback، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven گوگل را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۱ لین‌بک-گرید

نسخه ۱.۱.۰-آلفا۰۱

۱۹ مه ۲۰۲۶

androidx.leanback:leanback-grid:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • برای تغییر موقعیت انتخاب شده بدون ایجاد اسکرول، setSelectedPositionToUnalignedChild و setSelectedPositionToAlignedChild را اضافه کنید. ( If53ab , b/499067714 )
  • برای پشتیبانی از snapping در حالت لمسی، setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) را ارائه می‌دهد. ( I55fbc )
  • پشتیبانی از SpanSizeLookup با قابلیت اشغال تمام spanها و ناحیه padding. ( I7f87c )
  • نمایش getNumColumns() و getNumRows() ( Icd8c0 , b/138276997 )

رفع اشکالات

نسخه ترجیحی Leanback نسخه ۱.۳

نسخه ۱.۳.۰-آلفا۰۱

۱۹ مه ۲۰۲۶

androidx.leanback:leanback:1.3.0-alpha01 منتشر شد. نسخه 1.3.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • پشتیبانی از SpanSizeLookup با قابلیت اشغال تمام spanها و ناحیه padding. ( I7f87c )
  • نمایش getNumColumns() و getNumRows() ( Icd8c0 , b/138276997 )
  • حذف حاشیه‌نویسی‌های منسوخ‌شده‌ی @RequiresApi(21) ( Ic4792 )

رفع اشکالات

نسخه ۱.۰.۰ Leanback-Grid

نسخه ۱.۰.۰

۲۳ آوریل ۲۰۲۵

androidx.leanback:leanback-grid:1.0.0 منتشر شد. این نسخه هیچ تغییری ندارد، فقط به نسخه پایدار (stable) منتقل شده است.

نسخه ۱.۰.۰-rc01

۹ آوریل ۲۰۲۵

androidx.leanback:leanback-grid:1.0.0-rc01 منتشر شد. این نسخه هیچ کامیت مهمی ندارد و فقط کتابخانه را به نسخه پایدار منتقل می‌کند.

نسخه ۱.۰.۰-آلفا۰۳

۱۵ نوامبر ۲۰۲۳

androidx.leanback:leanback-grid:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

به‌روزرسانی‌های وابستگی

  • به‌روزرسانی برای وابستگی به RecyclerView 1.3.2 برای رفع مشکل خرابی رایج در برنامه‌های تلویزیون ( I2c3a0 ، b/292114537 )

نسخه ۱.۰.۰-آلفا۰۲

۶ سپتامبر ۲۰۲۳

androidx.leanback:leanback-grid:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

تغییرات API

  • برای اینکه بتوان ویژگی‌های focus out را به صورت برنامه‌نویسی شده تنظیم کرد، setFocusOutAllowed عمومی کرد. ( Iebd99 )

رفع اشکالات

  • با تنظیم نام کلاس اطلاعات گره a11y ( I12812 ) اطمینان حاصل کنید که سرویس‌های a11y با شبکه‌ها به عنوان شبکه رفتار می‌کنند.
  • صدای ناوبری هنگام اسکرول روان حذف شد ( f49767 )

نسخه ۱.۰.۰-آلفا۰۱

۱۷ نوامبر ۲۰۲۱

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 )

نسخه ۱.۲.۰ لین‌بک-ترجیحات لین‌بک

نسخه ۱.۲.۰

۲۳ آوریل ۲۰۲۵

androidx.leanback:leanback:1.2.0 و androidx.leanback:leanback-preference:1.2.0 منتشر شدند. این نسخه هیچ تغییری نداشته و فقط به نسخه پایدار (stable) ارتقا یافته است.

نسخه ۱.۲.۰-rc01

۹ آوریل ۲۰۲۵

androidx.leanback:leanback:1.2.0-rc01 و androidx.leanback:leanback-preference:1.2.0-rc01 منتشر شده‌اند. این نسخه هیچ کامیت مهمی ندارد و فقط کتابخانه را به نسخه پایدار منتقل می‌کند.

نسخه ۱.۲.۰-آلفا۰۴

۱۵ نوامبر ۲۰۲۳

androidx.leanback:leanback:1.2.0-alpha04 و androidx.leanback:leanback-preference:1.2.0-alpha04 منتشر شدند. نسخه 1.2.0-alpha04 شامل این کامیت‌ها است.

رفع اشکالات

به‌روزرسانی وابستگی

  • به‌روزرسانی نیاز به recyclerview به نسخه ۱.۳.۲ برای رفع مشکل کرش کردن رایج در برنامه‌های تلویزیونی

نسخه ۱.۲.۰-آلفا۰۳

۶ سپتامبر ۲۰۲۳

androidx.leanback:leanback:1.2.0-alpha03 و androidx.leanback:leanback-preference:1.2.0-alpha03 منتشر شدند. نسخه 1.2.0-alpha03 شامل این کامیت‌ها است.

تغییرات API

  • برای پشتیبانی بهتر از تم AppCompat، GuidedActionAppCompatEditText اضافه شد. ( ab7cf1 ، dc954d )

نسخه ۱.۲.۰-آلفا۰۲

۱۷ نوامبر ۲۰۲۱

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 )

نسخه ۱.۲.۰-آلفا۰۱

۲۱ ژوئیه ۲۰۲۱

androidx.leanback:leanback:1.2.0-alpha01 و androidx.leanback:leanback-preference:1.2.0-alpha01 منتشر شدند. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • GridLayoutManager را به صورت عمومی و قابل تعویض در BaseGridView قرار داد. ( f316b5 )

تغییرات API

  • GridLayoutManager را به صورت عمومی و قابل تعویض در BaseGridView قرار داد. ( f316b5 )

نسخه ۱.۱.۰

نسخه ۱.۱.۰-آلفا۰۱

۱۹ مه ۲۰۲۶

androidx.leanback:leanback-grid:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • برای تغییر موقعیت انتخاب شده بدون ایجاد اسکرول، setSelectedPositionToUnalignedChild و setSelectedPositionToAlignedChild را اضافه کنید. ( If53ab , b/499067714 )
  • برای پشتیبانی از snapping در حالت لمسی، setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) را ارائه می‌دهد. ( I55fbc )
  • از SpanSizeLookup با قابلیت اشغال تمام spanها و ناحیه padding پشتیبانی می‌کند. ( I7f87c )
  • نمایش getNumColumns() و getNumRows() ( Icd8c0 , b/138276997 )

رفع اشکالات

نسخه ۱.۱.۰-rc02 لین‌بک

۲۱ ژوئیه ۲۰۲۱

androidx.leanback:leanback:1.1.0-rc02 منتشر شد. نسخه 1.1.0-rc02 شامل این کامیت‌ها است.

رفع اشکالات

  • اشکال مربوط به تکه تکه شدن جزئیات در پس‌زمینه برطرف شد. ( 40d8e3 )

نسخه ترجیحی Leanback Leanback 1.1.0-rc01

۷ آوریل ۲۰۲۱

androidx.leanback:leanback:1.1.0-rc01 و androidx.leanback:leanback-preference:1.1.0-rc01 منتشر شدند. نسخه ۱.۱.۰-rc01 شامل این کامیت‌ها است.

  • رفع مشکل نشت نما در SearchSupportFragment() ( 6c47a1 ، b/171909417 )
  • تشخیص گفتار برای SearchSupportFragment اختیاری شد ( 4ff949 ، b/169936953 )

نسخه ۱.۱ صفحه‌بندی بدون نیاز به اینترنت (Leanback-Paging)

نسخه ۱.۱.۰

۲۳ آوریل ۲۰۲۵

androidx.leanback:leanback-paging:1.1.0 و androidx.leanback:leanback-tab:1.1.0 منتشر شدند. این نسخه هیچ تغییری نداشته و فقط به نسخه پایدار (stable) منتقل شده است.

نسخه ۱.۱.۰-rc01

۹ آوریل ۲۰۲۵

androidx.leanback:leanback-paging:1.1.0-rc01 و androidx.leanback:leanback-tab:1.1.0-rc01 منتشر شده‌اند. این نسخه هیچ کامیت مهمی ندارد و فقط کتابخانه را به نسخه پایدار منتقل می‌کند.

نسخه ۱.۱.۰-آلفا۱۱

۱۵ نوامبر ۲۰۲۳

androidx.leanback:leanback-paging:1.1.0-alpha11 بدون هیچ تغییری منتشر شده است. نسخه 1.1.0-alpha11 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۱۰

۶ سپتامبر ۲۰۲۳

androidx.leanback:leanback-paging:1.1.0-alpha10 منتشر شد. نسخه 1.1.0-alpha10 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • به‌روزرسانی leanback-paging به Paging 3.1.0. ( 882ed1 )

نسخه ۱.۱.۰-alpha09 از Leanback-Paging

۱۷ نوامبر ۲۰۲۱

androidx.leanback:leanback-paging:1.1.0-alpha09 منتشر شد. نسخه 1.1.0-alpha09 شامل این کامیت‌ها است.

رفع اشکالات

  • برای استفاده از جدیدترین APIهای صفحه‌بندی به‌روزرسانی شد.

نسخه ۱.۱.۰-alpha08 از Leanback-Paging

۲۱ ژوئیه ۲۰۲۱

androidx.leanback:leanback-paging:1.1.0-alpha08 منتشر شد. نسخه 1.1.0-alpha08 شامل این کامیت‌ها است.

تغییرات API

  • APIهای .peek() و .snapshot() به PagingDataAdapter اضافه شدند که امکان بررسی داده‌های ارائه شده را بدون فعال کردن فراخوانی صفحه فراهم می‌کنند. ( Ic8917 )

نسخه ۱.۱.۰-alpha07 از Leanback-Paging

۱۳ ژانویه ۲۰۲۱

androidx.leanback:leanback-paging:1.1.0-alpha07 منتشر شد. نسخه 1.1.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

  • ویژگی‌های کمکی CombinedLoadStates.refresh ، CombinedLoadStates.prepend و CombinedLoadStates.append به‌روزرسانی شدند تا فقط پس از اینکه هر دو حالت بارگذاری واسطه و منبع در NotLoading قرار گرفتند، از Loading به NotLoading تغییر حالت دهند تا از اعمال به‌روزرسانی از راه دور اطمینان حاصل شود. ( I65619 )

Leanback Leanback-Preference Leanback-Tab نسخه 1.1.0-beta01

۲ دسامبر ۲۰۲۰

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 در backstack ( I34483 ، b/171909417 )
  • رفع مشکل نشت نما هنگام قرار دادن DetailsSupportFragment در backstack ( Ifec9e ، b/171909417 )
  • رفع مشکل نشت نما هنگام انتقال RowsSupportFragment به backstack ( I985d4 ، b/171909417 )
  • رفع مشکل انیمیشن انتقال پس‌زمینه GuidedStepSupportFragment ( I86d15 ، b/173647688 )
  • رفع خطای IllegalArgumentException هنگام بازیابی GuidedStepSupportFragment ( Ic829f ، b/172000115 )
  • رفع خطای GridLayoutManager NullPointerException در تابع findContainingItemView() هنگام clearFocus() (با شناسه Id0e42 )

نسخه ۱.۱.۰-alpha06 از Leanback-Paging

۲ دسامبر ۲۰۲۰

androidx.leanback:leanback-paging:1.1.0-alpha06 منتشر شد. نسخه 1.1.0-alpha06 شامل این کامیت‌ها است.

تغییرات API

  • رابط‌های برنامه‌نویسی dataRefreshFlow / dataRefreshListener حذف شده‌اند زیرا با به‌روزرسانی‌های loadStateFlow / Listener زائد می‌شوند. برای کسانی که مهاجرت می‌کنند، معادل loadStateFlow به صورت زیر است:

    loadStateFlow.distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is NotLoading }

    ( Ib5570 ، b/173530908 )

  • متدهای dataRefreshFlow/Listener را با استفاده از عبارت replaceWith به طور کامل منسوخ کنید. ( I6e2dd )

نسخه ۱.۱.۰-آلفا۰۵

۱ اکتبر ۲۰۲۰

androidx.leanback:leanback-*:1.1.0-alpha05 منتشر شد. نسخه 1.1.0-alpha05 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • بگذارید ناوبری A11Y از ویژگی‌های focusOutFront و focusOutEnd در GridLayoutManager پیروی کند. ( b/161390258 )

رفع اشکالات

  • رفع مشکل نشتی View در GuidanceStylist.onDestroyView() ( b/164841457 )
  • رفع مشکل ConcatAdapter در GridLayoutManager ( b/165694295 )
  • leanback-tab: بهبودهای Javadoc و بازسازی جزئی کد ( aosp/1393383 )
  • متد setRecyclerView را از API حذف کنید، این متد زمانی اضافه شد که همین متد در RecyclerView منسوخ شده بود. کتابخانه leanback را به‌روزرسانی کنید تا از متد جدید addRecyclerListener API در RecyclerView استفاده کند. ( I14798 )

نسخه ۱.۱.۰-آلفا۰۴

۱۱ آگوست ۲۰۲۰

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 اضافه شده است که ایجاد یک کد پایه واحد بین موبایل و تلویزیون را ساده می‌کند.

تغییرات API

  • آداپتور مبتنی بر asyncpagingdatadiffer برای ویجت‌های leanback ( If0dfe ) اضافه شد.
  • اضافه کردن یک TabLayout سفارشی برای استفاده به عنوان نوار ناوبری بالا در leanback ( I1e304 )

نسخه ۱.۱.۰-آلفا۰۳

۱۸ دسامبر ۲۰۱۹

androidx.leanback:leanback:1.1.0-alpha03 و androidx.leanback:leanback-preference:1.1.0-alpha03 منتشر شدند. Leanback نسخه 1.1.0-alpha03 شامل این کامیت‌ها و Leanback-Preference نسخه 1.1.0-alpha03 شامل این کامیت‌ها است .

ویژگی‌های جدید

  • BaseGridView اکنون از سرعت‌های پیمایش سفارشی پشتیبانی می‌کند ( aosp/952718 )
  • لمس آیتم‌های مرحله‌ای هدایت‌شده راحت‌تر شد ( aosp/1167964 )
  • BaseGridView OnLayoutCompleteListener را در معرض نمایش قرار داد تا برنامه‌ها بتوانند پس از مرحله layout، تبدیلات View را انجام دهند. ( aosp/1164409 )

تغییرات API

  • یک API جدید برای امکان سفارشی‌سازی سرعت پیمایش BaseGridView اضافه شد ( aosp/952718 )
  • یک API جدید برای اضافه کردن OnLayoutCompleteListener در BaseGridView اضافه شد ( aosp/1164409 )

رفع اشکالات

  • اشکالی که باعث می‌شد fast layout pass ترازبندی یک فرزند را به‌روزرسانی نکند، برطرف شد. ( aosp/1122745 )
  • رفع مشکل سرریز پشته در ویجت Picker هنگام تغییر فوکوس ( aosp/1168473 )

تغییرات وابستگی

  • Leanback-preference: وابستگی androidx.preference را به 1.1.0 ( aosp/1181902 ) پین کرد.

نسخه ۱.۱.۰-آلفا۰۲

۷ مه ۲۰۱۹

androidx.leanback:leanback:1.1.0-alpha02 و androidx.leanback:leanback-preference:1.1.0-alpha02 منتشر شدند. کامیت‌های موجود در این نسخه می‌توانند کامیت‌های leanback و leanback-preference باشند.

ویژگی‌های جدید

  • RowsSupportFragment اکنون اجازه دارد ViewHolders را با سایر RowsSupportFragmentها به اشتراک بگذارد، که این امر عملکرد رابط کاربری چند تبی را بهبود می‌بخشد.

تغییرات API

  • PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() اضافه شد تا به برنامه اجازه دهد هنگام فشار دادن DPAD، پنهان‌سازی/نمایش خودکار کنترل‌های پخش را غیرفعال کند.

رفع اشکالات

  • مشکل مربوط به تم قطعات leanback-preference که به دلیل تغییر در کتابخانه تنظیمات ایجاد شده بود، برطرف شد.
  • رفع اشکال ناوبری هنگام فشار دادن کلید BACK در SearchEditText

نسخه ۱.۱.۰-آلفا۰۱

۳۰ ژانویه ۲۰۱۹

androidx.leanback:leanback 1.1.0-alpha01 منتشر شد.

ویژگی‌های جدید

  • ویجت PinPicker اضافه شد.
  • برش طرح کلی اکنون به طور پیش‌فرض در دستگاه‌های کم‌رم غیرفعال است.
  • مجاز به نمایش/پنهان کردن کنترل‌های PlaybackSupportFragment سفارشی ( b/122918400 )

تغییرات API

  • قطعات چارچوب منسوخ شدند.
  • کلاس جدید 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 اضافه شد، کلاس‌های قطعه‌بندی چارچوب منسوخ شدند.
  • رنگ‌ها و فونت‌ها اکنون بر اساس ویژگی‌های قالب فریم‌ورک هستند.

تغییرات API

  • کلاس‌های جدید قطعه‌بندی اندروید‌ایکس، کلاس‌های قطعه‌بندی چارچوب منسوخ شدند.