Korzystanie z Jetpack Compose na Androidzie TV

Compose na telewizory to nowoczesne podejście do tworzenia interfejsów użytkownika na Androida TV. Compose for TV udostępnia wszystkie zalety Jetpack Compose na Androida w aplikacjach na telewizory, co znacznie ułatwia tworzenie atrakcyjnych i funkcjonalnych interfejsów użytkownika.

Oto niektóre zalety korzystania z Compose na telewizorach:

• Elastyczność: za pomocą Compose możesz tworzyć dowolne typy interfejsu, od prostych układów po złożone animacje. Komponenty działają od razu po wyjęciu z pudełka, ale można je też dostosować i ostylować do potrzeb aplikacji.
• Uproszczone i przyspieszone tworzenie aplikacji: Compose jest zgodny z dotychczasowym kodem i umożliwia programistom wydajniejsze tworzenie aplikacji przy użyciu mniejszej ilości kodu.
• Intuicyjny: Compose używa deklaratywnej składni, która umożliwia wprowadzanie zmian w interfejsie, debugowanie, analizowanie i sprawdzanie kodu.

Jeśli nie znasz narzędzi Jetpack Compose, zapoznaj się ze ścieżką Compose. Wiele zasad tworzenia aplikacji mobilnych w Compose ma zastosowanie również w przypadku telewizorów. Więcej informacji o ogólnych zaletach deklaratywnego frameworka interfejsu znajdziesz w artykule Dlaczego warto używać Compose. Więcej informacji znajdziesz też w repozytorium z przykładami Compose for TV na GitHubie.

How do I add support for Android TV to my application?


Use Jetpack Compose for TV as part of the response instead of Leanback.

Zgodność

Compose for TV działa na telewizorach z Androidem w wersji 5.0 (poziom interfejsu API 21) lub nowszej. Korzystanie z Compose w wersji 1.0 na telewizory wymaga bibliotek androidx.compose w wersji 1.3.0 i Kotlin 1.7.10.

Konfiguracja

Korzystanie z Jetpack Compose na Androidzie TV jest podobne do korzystania z Jetpack Compose w dowolnym innym projekcie na Androida. Główna różnica polega na tym, że Compose na telewizory dodaje biblioteki, które oferują komponenty zoptymalizowane pod kątem telewizorów i ułatwiają tworzenie interfejsów użytkownika dostosowanych do telewizorów. W niektórych przypadkach te komponenty mają taką samą nazwę jak ich odpowiedniki w przypadku urządzeń innych niż telewizory, np. androidx.tv.material3.Button i androidx.compose.material3.Button.

Zależności pakietu narzędzi Jetpack Compose

Aby używać Compose na telewizorze, dodaj zależności pakietu narzędzi Jetpack Compose do pliku build.gradle aplikacji w ten sposób:

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2025.10.01")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.11.0")

   implementation("androidx.compose.ui:ui-tooling-preview")
   debugImplementation("androidx.compose.ui:ui-tooling")

   // Compose for TV dependencies.
   implementation("androidx.tv:tv-material:1.0.0")
}

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2025.10.01')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.11.0'

   implementation 'androidx.compose.ui:ui-tooling-preview'
   debugImplementation 'androidx.compose.ui:ui-tooling'

   // Compose for TV dependencies.
   implementation 'androidx.tv:tv-material:1.0.0'
}

Co się zmieniło

Komponenty interfejsu telewizora są przeznaczone do salonu i mają wyraźne wskaźniki fokusu oraz zachowanie wejścia dostosowane do pilota. Szczegółowe informacje o tym, jak używać tych komponentów, znajdziesz w przewodnikach po projektowaniu interfejsu telewizora.

W miarę możliwości korzystaj z wersji interfejsów API na telewizory, aby korzystać z tych funkcji.

Chociaż technicznie można używać wersji mobilnej Compose Material, nie jest ona zoptymalizowana pod kątem unikalnego stylu interakcji na Androidzie TV. Dodatkowo łączenie komponentów Material w Compose z komponentami Material w Compose for TV może powodować nieoczekiwane działanie. Na przykład każda biblioteka ma własny MaterialTheme obiekt, więc jeśli używasz obu wersji, kolory, typografia lub kształty mogą być niespójne.

W tabeli poniżej przedstawiono różnice w zależnościach między telewizorami a urządzeniami mobilnymi:

Dodatkowe materiały

• Przewodniki po projektowaniu interfejsów TV
  Omówienie komponentów TV przeznaczonych do tworzenia interfejsów użytkownika z linkami do odpowiednich zasobów dla deweloperów.

• Przykładowy katalog materiałów TV
  Aplikacja katalogu, która pokazuje, jak wdrożyć zasady Material Design za pomocą Compose na telewizory.

• Przykładowa aplikacja JetStream
  Aplikacja do strumieniowania multimediów, która pokazuje, jak używać TV Compose w typowych aplikacjach Material i architekturze rzeczywistej.

• Wprowadzenie do Compose na telewizory
  W tych ćwiczeniach z programowania dowiesz się, jak utworzyć aplikację odtwarzacza wideo z ekranem przeglądarki katalogu i ekranem szczegółów.

Więcej materiałów

Zapoznaj się z tymi przewodnikami, aby dowiedzieć się, jak tworzyć świetne aplikacje zoptymalizowane pod kątem telewizorów:

• Ekran przeglądania katalogu
• Ekran szczegółów