TV용 Compose로 이전
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Leanback UI 도구 키트에서 Android TV용 Compose로 이전하려면 다음 단계를 따르세요.
사용 중인 구성요소 (사전 빌드된 프래그먼트 내에 제공된 구성요소 포함)를 파악하고 UI의 구조와 데이터가 앱을 통해 흐르는 방식을 이해하여 현재 Leanback 구현을 평가합니다.
Compose를 점진적으로 학습하고 적응할 수 있도록 TV 앱의 개별 화면을 Compose로 이전합니다.
동일한 앱 내에서 Leanback과 Compose를 모두 사용하여 점진적인 이전 프로세스를 허용할 수 있지만, TV 애플리케이션을 단일 활동으로 변환하는 것을 목표로 한 번에 전체 프래그먼트를 교체하는 것으로 시작합니다.
소규모로 시작합니다. 한 번에 모든 항목을 이전하려고 하지 마세요. 설정이나 계정 화면과 같은 작은 구성요소부터 시작하여 앱을 점진적으로 살펴봅니다.
리소스 섹션에 나열된 리소스의 문서와 예시를 참고하세요.
Jetpack 라이브러리를 사용하여 TV용 Compose의 전용 구성요소를 활용합니다. 디자인 가이드에서 바로 사용 가능한 컴포저블을 맞춤설정하고 확장하여 멋진 TV UI를 빌드하는 방법을 알아보세요.
Compose 선언적 프로그래밍 패러다임을 지원하도록 데이터 및 상태 관리를 조정합니다. 적응하려면 앱에서 데이터와 상태를 관리하는 방식을 변경해야 할 수 있습니다. ViewModel
및 Jetpack Compose 내부 상태 관리 메커니즘을 사용하여 앱에서 데이터와 상태를 관리하세요.
앱의 더 복잡한 부분을 이전할 때 테스트하고 반복합니다.
발생한 버그에 대해 Stack Overflow의 활발한 Android 개발자 커뮤니티와 소통하거나 공개 버그 추적기를 통해 버그를 제출하세요.
리소스
Compose를 처음 접하는 사용자이든 이미 Compose로 이전하는 중인 사용자이든 최신 Android 개발 툴킷인 Jetpack Compose로 TV UI를 빌드하기 위한 권장사항을 알아볼 수 있는 다양한 리소스를 확인해 보세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Migrate to Compose for TV\n\nTo migrate from the Leanback UI toolkit to Compose for Android TV, follow these steps:\n\n- **Assess your current Leanback implementation** by identifying the components\n you're using (including those that are provided inside the prefabricated\n fragments) and understanding how your UI is structured and how data flows\n through your app.\n\n- **Migrate individual screens** of your TV app to Compose so you can learn and adapt to Compose\n gradually.\n\n - While you can use both Leanback and Compose within the same app to allow for\n a gradual migration process, begin by replacing entire fragments at a time\n with a goal of converting your TV application into a single activity.\n\n - Start small. Don't try to migrate everything at once. Begin with smaller\n components like settings or account screens and gradually work your way\n through the app.\n\n - Refer to documentation and examples in the resources listed in the\n [Resources](#resources) section.\n\n- **Leverage dedicated components** from Compose for TV by using [the Jetpack\n libraries](/jetpack/androidx/releases/tv). Consult our [design guides](/design/ui/tv/guides/components) to explore\n how you can customize and extend ready-to-use composables to build\n beautiful TV UIs.\n\n- **Adapt your data and state management** to support the Compose [declarative\n programming paradigm](/develop/ui/compose/mental-model#paradigm). Adaptation might require changes in how you manage\n data and state in your app. Use [`ViewModel`](/reference/kotlin/androidx/lifecycle/ViewModel)\n and Jetpack Compose internal state management mechanisms to manage data and\n state in your app.\n\n- **[Test](/develop/ui/compose/testing) and iterate** as you migrate more complex parts of your app.\n\nEngage with the active Android [developer community on Stack\nOverflow](https://stackoverflow.com/questions/tagged/android-jetpack-compose-tv) for any bugs you encounter, or submit the bugs through\nour [public bug tracker](/jetpack/androidx/releases/tv#feedback).\n\nResources\n---------\n\nWhether you're new to Compose or are in the process of migrating to Compose\nalready, our large collection of resources are here to help you learn best\npractices for building TV UIs with the modern Android development toolkit,\nJetpack Compose:\n\n- [Compose for TV integration guides](/training/tv/playback/compose)\n- [TV design guides](/design/ui/tv/guides/components)\n- [Introduction to Compose for TV](/codelabs/compose-for-tv-introduction) codelab\n- [Library release notes](/jetpack/androidx/releases/tv)\n- [JetStream](https://github.com/android/tv-samples/tree/main/JetStreamCompose) video streaming sample app\n- [JetCaster](https://github.com/android/compose-samples/tree/main/Jetcaster/tv-app) audio streaming sample app\n- [Component samples](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:tv/samples/src/main/java/androidx/tv/samples/)"]]