Перейдите на Compose для ТВ
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Чтобы перейти с набора инструментов Leanback UI на Compose для Android TV, выполните следующие действия:
Оцените свою текущую реализацию Leanback, определив используемые вами компоненты (в том числе те, которые предоставляются внутри готовых фрагментов) и поймите, как структурирован ваш пользовательский интерфейс и как данные проходят через ваше приложение.
Перенесите отдельные экраны вашего ТВ-приложения в Compose, чтобы вы могли постепенно учиться и адаптироваться к Compose.
Хотя вы можете использовать Leanback и Compose в одном приложении, чтобы обеспечить процесс постепенной миграции, начните с замены целых фрагментов за раз, чтобы преобразовать ваше телевизионное приложение в единое действие.
Начните с малого. Не пытайтесь перенести все сразу. Начните с небольших компонентов, таких как настройки или экраны учетной записи, и постепенно продвигайтесь по приложению.
Обратитесь к документации и примерам в ресурсах, перечисленных в разделе «Ресурсы» .
Используйте специальные компоненты Compose for TV с помощью библиотек Jetpack . Ознакомьтесь с нашими руководствами по дизайну , чтобы узнать, как можно настраивать и расширять готовые к использованию составные элементы для создания красивых пользовательских интерфейсов телевизоров.
Адаптируйте управление данными и состоянием для поддержки парадигмы декларативного программирования Compose. Адаптация может потребовать изменений в том, как вы управляете данными и состоянием в своем приложении. Используйте внутренние механизмы управления состоянием ViewModel
и Jetpack Compose для управления данными и состоянием в вашем приложении.
Тестируйте и выполняйте итерации по мере миграции более сложных частей вашего приложения.
Свяжитесь с активным сообществом разработчиков Android на Stack Overflow, чтобы узнать о любых ошибках, с которыми вы сталкиваетесь, или сообщайте об ошибках через нашу общедоступную систему отслеживания ошибок .
Ресурсы
Независимо от того, являетесь ли вы новичком в Compose или уже находитесь в процессе перехода на Compose, наша большая коллекция ресурсов поможет вам изучить лучшие практики создания пользовательского интерфейса телевизора с помощью современного инструментария разработки для Android Jetpack Compose:
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[null,null,["Последнее обновление: 2025-07-29 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/)"]]