Отклониться назад

Вместо этого артефакта используйте программу Compose for TV.
Последнее обновление Стабильный релиз Предварительная версия релиза Бета-версия Альфа-версия
19 мая 2026 г. 1.2.0 - - 1.3.0-alpha01

Объявление зависимостей

Чтобы добавить зависимость от Leanback, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google 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. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Leanback-Grid Версия 1.1

Версия 1.1.0-alpha01

19 мая 2026 г.

Выпущена версия androidx.leanback:leanback-grid:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Добавьте setSelectedPositionToUnalignedChild и setSelectedPositionToAlignedChild , чтобы изменять выбранное положение без запуска прокрутки. ( If53ab , b/499067714 )
  • Предоставляет setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) для поддержки привязки к сенсорному экрану. ( I55fbc )
  • Поддержка SpanSizeLookup с возможностью заполнения всех областей span и padding area. ( I7f87c )
  • Предоставить доступ к getNumColumns() и getNumRows() ( Icd8c0 , b/138276997 )

Исправлены ошибки

  • Исправлена ​​утечка дочерних представлений после перезагрузки адаптера. ( I636a0 )
  • Перенос minSdk по умолчанию с API 21 на API 23 ( Ibdfca , b/380448311 , b/435705964 , b/435705223 )

Leanback Leanback-Preference Version Version 1.3

Версия 1.3.0-alpha01

19 мая 2026 г.

Выпущена версия androidx.leanback:leanback:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Поддержка SpanSizeLookup с возможностью заполнения всех областей span и padding area. ( I7f87c )
  • Предоставить доступ к getNumColumns() и getNumRows() ( Icd8c0 , b/138276997 )
  • Удаление устаревших аннотаций @RequiresApi(21) ( Ic4792 )

Исправлены ошибки

  • Исправлена ​​утечка дочерних представлений после перезагрузки адаптера. ( I636a0 )
  • Перенос minSdk по умолчанию с API 21 на API 23 ( Ibdfca , b/380448311 , b/435705964 , b/435705223 )

Leanback-Grid Версия 1.0.0

Версия 1.0.0

23 апреля 2025 г.

Выпущена версия androidx.leanback:leanback-grid:1.0.0 . В этой версии нет никаких изменений, она просто перенесена в стабильную ветку.

Версия 1.0.0-rc01

9 апреля 2025 г.

Выпущена версия androidx.leanback:leanback-grid:1.0.0-rc01 . В ней нет существенных изменений, и она лишь переносит библиотеку в стабильную версию.

Версия 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 содержит следующие коммиты.

Изменения в API

  • Сделать 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

23 апреля 2025 г.

Выпущены версии androidx.leanback:leanback:1.2.0 и androidx.leanback:leanback-preference:1.2.0 . В этой версии нет никаких изменений, она просто перенесена в стабильную ветку.

Версия 1.2.0-rc01

9 апреля 2025 г.

Выпущены версии androidx.leanback:leanback:1.2.0-rc01 и androidx.leanback:leanback-preference:1.2.0-rc01 . В них нет существенных изменений, и они лишь переводят библиотеку в стабильную версию.

Версия 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 содержит следующие коммиты.

Изменения в API

  • Добавлена 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 )

Изменения в API

  • Сделал Leanback GridLayoutManager общедоступным и заменяемым в BaseGridView. ( f316b5 )

Версия 1.1.0

Версия 1.1.0-alpha01

19 мая 2026 г.

Выпущена версия androidx.leanback:leanback-grid:1.1.0-alpha01 . Версия 1.1.0-alpha01 содержит следующие коммиты .

Изменения в API

  • Добавьте setSelectedPositionToUnalignedChild и setSelectedPositionToAlignedChild , чтобы изменять выбранное положение без запуска прокрутки. ( If53ab , b/499067714 )
  • Предоставляет метод setFocusScrollStrategy(FOCUS_SCROLL_ALIGNED_AND_SNAP) для поддержки привязки к сенсорному экрану. ( I55fbc )
  • Поддержка функции SpanSizeLookup с возможностью заполнения всех областей span и padding area. ( I7f87c )
  • Предоставить доступ к функциям getNumColumns() и getNumRows() ( Icd8c0 , b/138276997 )

Исправлены ошибки

  • Исправлена ​​утечка дочерних представлений после перезагрузки адаптера. ( I636a0 )
  • Перенос минимального SDK по умолчанию с API 21 на API 23 ( Ibdfca , b/380448311 , b/435705964 , b/435705223 )

Leanback Версия 1.1.0-rc02

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 )

Leanback-Paging Версия 1.1

Версия 1.1.0

23 апреля 2025 г.

Выпущены версии androidx.leanback:leanback-paging:1.1.0 и androidx.leanback:leanback-tab:1.1.0 . В этой версии нет никаких изменений, она просто перенесена в стабильную ветку.

Версия 1.1.0-rc01

9 апреля 2025 г.

Выпущены версии androidx.leanback:leanback-paging:1.1.0-rc01 и androidx.leanback:leanback-tab:1.1.0-rc01 . В них нет существенных изменений, и они лишь переводят библиотеку в стабильную версию.

Версия 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-paging до версии 3.1.0. ( 882ed1 )

Leanback-Paging Version 1.1.0-alpha09

17 ноября 2021 г.

Выпущена версия androidx.leanback:leanback-paging:1.1.0-alpha09 . Версия 1.1.0-alpha09 содержит следующие коммиты.

Исправлены ошибки

  • Обновлено с использованием новейших API для постраничной навигации.

Leanback-Paging Version 1.1.0-alpha08

21 июля 2021 г.

Выпущена версия androidx.leanback:leanback-paging:1.1.0-alpha08 . Версия 1.1.0-alpha08 содержит следующие коммиты.

Изменения в API

  • В PagingDataAdapter добавлены API-функции .peek() и .snapshot() , позволяющие просматривать отображаемые данные без запуска загрузки страницы. ( Ic8917 )

Leanback-Paging Version 1.1.0-alpha07

13 января 2021 г.

Выпущена версия androidx.leanback:leanback-paging:1.1.0-alpha07 . Версия 1.1.0-alpha07 содержит следующие коммиты.

Изменения в API

  • Обновлены вспомогательные свойства CombinedLoadStates.refresh , CombinedLoadStates.prepend , CombinedLoadStates.append , чтобы переход из Loading в NotLoading только после того, как состояния загрузки посредника и источника находились NotLoading , что гарантирует применение удаленного обновления. ( I65619 )

Leanback 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 в стек возврата ( 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 )

Leanback-Paging Version 1.1.0-alpha06

2 декабря 2020 г.

Выпущена версия androidx.leanback:leanback-paging:1.1.0-alpha06 . Версия 1.1.0-alpha06 содержит следующие коммиты.

Изменения в API

  • API-интерфейсы 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 содержит следующие коммиты.

Новые функции

  • Пусть навигация A11Y учитывает атрибуты focusOutFront и focusOutEnd менеджера GridLayoutManager. ( b/161390258 )

Исправлены ошибки

  • Исправлена ​​утечка памяти в GuidanceStylist.onDestroyView() ( b/164841457 )
  • Исправление ConcatAdapter в GridLayoutManager ( b/165694295 )
  • leanback-tab: Улучшения Javadoc и незначительная рефакторизация кода ( aosp/1393383 )
  • Удалите метод setRecyclerView из API, который был добавлен, когда этот же метод был объявлен устаревшим в RecyclerView. Обновите библиотеку leanback, чтобы она использовала новый метод API 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 обеспечивает верхнюю навигацию (обычно отображаемую горизонтально в верхней части приложения) в режиме просмотра .
  • Paging for Leanback упрощает добавление поддержки постраничной навигации в RecyclerView.Adapter .
  • Добавлены темы, совместимые с приложениями, для Leanback, что упростит создание единой кодовой базы для мобильных устройств и телевизоров.

Изменения в API

  • Добавлен адаптер на основе 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 . Версия Leanback 1.1.0-alpha03 содержит следующие коммиты , а версия Leanback-Preference 1.1.0-alpha03 содержит следующие коммиты .

Новые функции

  • BaseGridView теперь поддерживает настраиваемую скорость прокрутки ( aosp/952718 )
  • Улучшена функциональность сенсорного управления элементами пошагового обучения ( AOSP/1167964 )
  • Добавлен обработчик события OnLayoutCompleteListener для BaseGridView, позволяющий приложениям выполнять преобразования представления после этапа компоновки. ( aosp/1164409 )

изменения API

  • Добавлен новый API для настройки скорости прокрутки BaseGridView ( aosp/952718 )
  • Добавлен новый API для добавления OnLayoutCompleteListener в BaseGridView ( aosp/1164409 )

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой быстрый проход компоновки не обновлял выравнивание дочернего элемента. ( aosp/1122745 )
  • Исправлена ​​ошибка переполнения стека в виджете Picker при смене фокуса ( 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 commits и leanback-preference commits .

Новые функции

  • Теперь RowsSupportFragment может совместно использовать ViewHolders с другими RowsSupportFragment, что повысит производительность при работе с многовкладочным интерфейсом.

изменения API

  • Добавлена PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction() позволяющая приложению отключать автоматическое скрытие/отображение элементов управления воспроизведением при нажатии кнопки DPAD.

Исправлены ошибки

  • Исправлена ​​ошибка, из-за которой не работала тема Fragments leanback-preference, возникшая в результате изменения библиотеки настроек.
  • Исправлена ​​ошибка навигации при нажатии клавиши НАЗАД в поле поиска SearchEditText.

Версия 1.1.0-alpha01

30 января 2019 г.

Выпущена 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

  • Новые классы фрагментов androidx и классы фрагментов фреймворка устарели.