이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Leanback

API 참조
androidx.leanback.app
androidx.leanback.database
androidx.leanback.graphics
androidx.leanback.media
androidx.leanback.preference
androidx.leanback.system
androidx.leanback.widget
androidx.leanback.widget.picker

이 아티팩트 대신 TV용 Compose를 사용하세요.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2025년 4월 23일	1.2.0	-	-	-

종속 항목 선언

Leanback의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    def leanback_version = "1.2.0"

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

Kotlin

dependencies {
    val leanback_version = "1.2.0"

    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을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

Leanback-Grid 버전 1.0.0

버전 1.0.0

2025년 4월 23일

androidx.leanback:leanback-grid:1.0.0이 출시되었습니다. 이 버전에는 변경사항이 없으며 안정화 버전으로 이동합니다.

버전 1.0.0-rc01

2025년 4월 9일

androidx.leanback:leanback-grid:1.0.0-rc01이 출시되었습니다. 여기에는 주요 커밋이 없으며 라이브러리를 안정화 버전으로만 이동합니다.

버전 1.0.0-alpha03

2023년 11월 15일

androidx.leanback:leanback-grid:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에 포함된 커밋을 확인하세요.

종속 항목 업데이트

RecyclerView 1.3.2에 종속되도록 업데이트하여 TV 앱의 일반적인 비정상 종료를 수정했습니다. (I2c3a0, b/292114537)

버전 1.0.0-alpha02

2023년 9월 6일

androidx.leanback:leanback-grid:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

포커스 아웃 속성을 프로그래매틱 방식으로 설정할 수 있도록 setFocusOutAllowed를 공개로 설정했습니다. (Iebd99)

버그 수정

a11y 노드 정보 클래스 이름을 설정하여 a11y 서비스에서 그리드가 그리드로 처리되도록 합니다. (I12812)
부드럽게 스크롤할 때 누락된 탐색 소리를 추가합니다. (f49767)

버전 1.0.0-alpha01

2021년 11월 17일

androidx.leanback:leanback-grid:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility 클래스/인터페이스를 leanback에서 새로운 leanback-grid 라이브러리로 이동했습니다. 이 변경사항으로 바이너리 호환성이 유지됩니다. leanback의 그리드 뷰 구성요소만 사용하려는 경우 leanback-grid를 종속 항목으로 직접 사용할 수 있습니다. (If1e49)

Leanback Leanback-Preference 버전 1.2.0

버전 1.2.0

2025년 4월 23일

androidx.leanback:leanback:1.2.0 및 androidx.leanback:leanback-preference:1.2.0이 출시되었습니다. 이 버전에는 변경사항이 없으며 안정화 버전으로 이동합니다.

버전 1.2.0-rc01

2025년 4월 9일

androidx.leanback:leanback:1.2.0-rc01 및 androidx.leanback:leanback-preference:1.2.0-rc01이 출시되었습니다. 여기에는 주요 커밋이 없으며 라이브러리를 안정화 버전으로만 이동합니다.

버전 1.2.0-alpha04

2023년 11월 15일

androidx.leanback:leanback:1.2.0-alpha04 및 androidx.leanback:leanback-preference:1.2.0-alpha04이 출시되었습니다. 버전 1.2.0-alpha04에 포함된 커밋을 확인하세요.

버그 수정

(I2c3a0, b/292114537)

종속 항목 업데이트

recyclerview 요구사항을 1.3.2로 업데이트하여 TV 앱의 일반적인 비정상 종료 문제를 해결합니다.

버전 1.2.0-alpha03

2023년 9월 6일

androidx.leanback:leanback:1.2.0-alpha03 및 androidx.leanback:leanback-preference:1.2.0-alpha03이 출시되었습니다. 버전 1.2.0-alpha03에 포함된 커밋을 확인하세요.

API 변경사항

AppCompat 테마를 더 잘 지원하기 위해 GuidedActionAppCompatEditText를 추가했습니다. (ab7cf1, dc954d)

버전 1.2.0-alpha02

2021년 11월 17일

androidx.leanback:leanback:1.2.0-alpha02 및 androidx.leanback:leanback-preference:1.2.0-alpha02가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

새로운 기능

BaseGridView, FacetProvider, FacetProviderAdapter, GridLayoutManager, HorizontalGridView, ItemAlignmentFacet, OnChildLaidOutListener, OnChildSelectedListener, OnChildViewHolderSelectedListener, VerticalGridView, ViewHolderTask, Visibility 클래스/인터페이스를 leanback에서 새로운 leanback-grid 라이브러리로 이동했습니다. 이 변경사항으로 바이너리 호환성이 유지됩니다. leanback의 그리드 뷰 구성요소만 사용하려는 경우 leanback-grid를 종속 항목으로 직접 사용할 수 있습니다. (If1e49)

버전 1.2.0-alpha01

2021년 7월 21일

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

Leanback 버전 1.1.0-rc02

2021년 7월 21일

androidx.leanback:leanback:1.1.0-rc02가 출시되었습니다. 버전 1.1.0-rc02에 포함된 커밋을 확인하세요.

버그 수정

세부정보 프래그먼트 배경 버그를 수정했습니다. (40d8e3)

Leanback Leanback-Preference 버전 1.1.0-rc01

2021년 4월 7일

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

2025년 4월 23일

androidx.leanback:leanback-paging:1.1.0 및 androidx.leanback:leanback-tab:1.1.0이 출시되었습니다. 이 버전에는 변경사항이 없으며 안정화 버전으로 이동합니다.

버전 1.1.0-rc01

2025년 4월 9일

androidx.leanback:leanback-paging:1.1.0-rc01 및 androidx.leanback:leanback-tab:1.1.0-rc01이 출시되었습니다. 여기에는 주요 커밋이 없으며 라이브러리를 안정화 버전으로만 이동합니다.

버전 1.1.0-alpha11

2023년 11월 15일

androidx.leanback:leanback-paging:1.1.0-alpha11은 변경사항 없이 출시되었습니다. 버전 1.1.0-alpha11에 포함된 커밋을 확인하세요.

버전 1.1.0-alpha10

2023년 9월 6일

androidx.leanback:leanback-paging:1.1.0-alpha10이 출시되었습니다. 버전 1.1.0-alpha10에 포함된 커밋을 확인하세요.

새로운 기능

leanback-paging을 Paging 3.1.0으로 업데이트합니다. (882ed1)

Leanback-Paging 버전 1.1.0-alpha09

2021년 11월 17일

androidx.leanback:leanback-paging:1.1.0-alpha09가 출시되었습니다. 버전 1.1.0-alpha09에 포함된 커밋을 확인하세요.

버그 수정

최신 페이징 API를 사용하도록 업데이트했습니다.

Leanback-Paging 버전 1.1.0-alpha08

2021년 7월 21일

androidx.leanback:leanback-paging:1.1.0-alpha08이 출시되었습니다. 버전 1.1.0-alpha08에 포함된 커밋을 확인하세요.

API 변경사항

PagingDataAdapter에 .peek() 및 .snapshot() API를 추가했으므로 페이지 가져오기를 트리거하지 않고도 제시된 데이터를 검사할 수 있습니다. (Ic8917)

Leanback-Paging 버전 1.1.0-alpha07

2021년 1월 13일

androidx.leanback:leanback-paging:1.1.0-alpha07이 출시되었습니다. 버전 1.1.0-alpha07에 포함된 커밋을 확인하세요.

API 변경사항

미디에이터 및 소스 로드 상태가 모두 NotLoading이 된 이후에만 편의성 속성 CombinedLoadStates.refresh, CombinedLoadStates.prepend, CombinedLoadStates.append가 Loading에서 NotLoading으로 전환되어 원격 업데이트가 적용될 수 있도록 업데이트되었습니다. (I65619)

Leanback Leanback-Preference Leanback-Tab 버전 1.1.0-beta01

2020년 12월 2일

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)
GuidedStepSupportFragment를 복원할 때 IllegalArgumentException이 발생하는 문제를 수정했습니다. (Ic829f, b/172002115)
clearFocus() 실행 시 findContainingItemView()에 GridLayoutManager NullPointerException이 발생하는 문제를 수정했습니다. (Id0e42)

Leanback-Paging 버전 1.1.0-alpha06

2020년 12월 2일

androidx.leanback:leanback-paging:1.1.0-alpha06이 출시되었습니다. 버전 1.1.0-alpha06에 포함된 커밋을 확인하세요.

API 변경사항

dataRefreshFlow/dataRefreshListener API가 loadStateFlow/Listener 업데이트와 중복되어 삭제되었습니다. 이러한 마이그레이션에서는 다음이 loadStateFlow에 해당합니다.
```
loadStateFlow.distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is NotLoading }
```
(Ib5570, b/173530908)
replaceWith 절을 사용하는 dataRefreshFlow/Listener 메서드를 완전히 지원 중단했습니다. (I6e2dd)

버전 1.1.0-alpha05

2020년 10월 1일

androidx.leanback:leanback-*:1.1.0-alpha05가 출시되었습니다. 버전 1.1.0-alpha05에 포함된 커밋을 확인하세요.

새로운 기능

A11Y 탐색이 GridLayoutManager focusOutFront 및 focusOutEnd 속성을 적용하도록 합니다. (b/161390258)

버그 수정

GuidanceStylist.onDestroyView()에서 뷰 누수가 발생하는 문제를 수정했습니다. (b/164841457)
GridLayoutManager의 ConcatAdapter를 수정했습니다. (b/165694295)
leanback-tab: Javadoc을 개선하고 몇 가지 코드를 리팩터링했습니다. (aosp/1393383)
RecyclerView에서 동일한 메서드가 지원 중단될 때 추가된 API에서 setRecyclerView 메서드를 삭제했습니다. RecyclerView의 새로운 addRecyclerListener API 메서드를 사용하도록 leanback lib를 업데이트했습니다. (I14798)

버전 1.1.0-alpha04

2020년 8월 11일

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에 관한 페이징 지원 추가를 단순화합니다.
휴대기기와 TV 간의 단일 코드베이스 생성을 단순화하는 Leanback용 AppCompat 테마를 추가했습니다.

API 변경사항

Leanback 위젯용 asyncpagingdatadiffer 기반 어댑터를 추가했습니다. (If0dfe)
Leanback에서 상단 탐색 메뉴로 사용할 맞춤 TabLayout을 추가했습니다. (I1e304)

버전 1.1.0-alpha03

2019년 12월 18일

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가 노출되기 때문에 레이아웃 패스 후 앱이 뷰 변환을 수행할 수 있습니다. (aosp/1164409 참조)

API 변경사항

맞춤 BaseGridView 스크롤 속도를 허용하기 위해 새 API를 추가했습니다. (aosp/952718 참조)
BaseGridView에서 OnLayoutCompleteListener를 추가하기 위한 새 API를 추가했습니다. (aosp/1164409 참조)

버그 수정

빠른 레이아웃 패스에서 하위 요소의 정렬을 업데이트하지 못하는 버그를 수정했습니다. (aosp/1122745 참조)
포커스가 변경될 때 선택 도구 위젯에서 발생하는 스택 오버플로 비정상 종료를 해결했습니다. (aosp/1168473 참조)

종속 항목 변경사항

Leanback-preference: androidx.preference의 종속 항목을 1.1.0으로 고정했습니다. (aosp/1181902 참조)

버전 1.1.0-alpha02

2019년 5월 7일

androidx.leanback:leanback:1.1.0-alpha02 및 androidx.leanback:leanback-preference:1.1.0-alpha02가 출시되었습니다. 이 버전에 포함된 커밋은 leanback 커밋 및 leanback-preference 커밋에서 확인할 수 있습니다.

새로운 기능

RowsSupportFragment가 이제 ViewHolder를 다른 RowsSupportFragment와 공유할 수 있으므로 다중 탭 UI 성능이 향상됩니다.

API 변경사항

방향 패드를 누를 때 앱에서 재생 컨트롤 자동 숨기기/표시 기능을 사용 중지할 수 있도록 PlaybackSupportFragment.setShowOrHideControlsOverlayOnUserInteraction()을 추가했습니다.

버그 수정

환경설정 라이브러리 변경으로 인해 손상된 leanback-preference 프래그먼트 테마를 수정했습니다.
SearchEditText에서 BACK 키를 누를 때 발생하는 탐색 버그를 수정했습니다.

버전 1.1.0-alpha01

2019년 1월 30일

androidx.leanback:leanback 1.1.0-alpha01이 출시되었습니다.

새로운 기능

PinPicker 위젯을 추가했습니다.
이제 RAM이 낮은 기기에서 윤곽선 클리핑을 기본적으로 사용하지 않도록 설정됩니다.
맞춤설정된 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 프래그먼트 클래스, 프레임워크 프래그먼트 클래스가 지원 중단되었습니다.