Przejdź do tworzenia na telewizorze
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aby przejść z pakietu narzędzi interfejsu Leanback do Compose na Androida TV, wykonaj te czynności:
Oceń aktualne wdrożenie Leanback, określając komponenty, których używasz (w tym te, które są dostarczane w ramach gotowych fragmentów), oraz poznając strukturę interfejsu użytkownika i przepływ danych w aplikacji.
Przenieś poszczególne ekrany aplikacji na telewizor do Compose, aby stopniowo zapoznać się z Compose i dostosować do niego.
Możesz używać zarówno Leanback, jak i Compose w ramach tej samej aplikacji, aby umożliwić stopniową migrację. Zacznij od zastąpienia całych fragmentów, aby przekształcić aplikację na telewizor w jedną aktywność.
Zacznij od małych kwot. Nie próbuj przenieść wszystkiego naraz. Zacznij od mniejszych elementów, takich jak ustawienia czy ekrany konta, i stopniowo przechodź przez aplikację.
Zapoznaj się z dokumentacją i przykładami w zasobach wymienionych w sekcji Zasoby.
Korzystaj z specjalnych komponentów w Compose na potrzeby telewizorów, używając bibliotek Jetpacka. Aby dowiedzieć się, jak dostosować i rozszerzyć gotowe komponenty, aby tworzyć atrakcyjne interfejsy użytkownika na telewizory, zapoznaj się z naszych przewodnikiem po projektowaniu.
Dostosuj zarządzanie stanem i danymi, aby obsługiwać deklaratywną paradygmatę programowania w Compose. Dostosowanie może wymagać zmiany sposobu zarządzania danymi i stanem w aplikacji. Aby zarządzać danymi i stanem w aplikacji, użyj ViewModel i wewnętrznych mechanizmów zarządzania stanem Jetpack Compose.
Testuj i ulepszaj aplikację podczas migracji bardziej złożonych jej części.
Aby zgłosić błędy, skontaktuj się z aktywnymi programistami Androida na Stack Overflow. Możesz też przesłać błędy za pomocą publicznego systemu śledzenia błędów.
Materiały
Niezależnie od tego, czy dopiero zaczynasz korzystać z Compose, czy też jesteś w trakcie migracji do tego narzędzia, znajdziesz tu dużą kolekcję zasobów, które pomogą Ci poznać sprawdzone metody tworzenia interfejsów użytkownika na telewizory za pomocą nowoczesnego pakietu Jetpack Compose:
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 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/)"]]
