Compose na TV 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 pięknych i funkcjonalnych interfejsów użytkownika.
Oto niektóre konkretne zalety korzystania z Compose for TV:
- Elastyczność: Compose umożliwia tworzenie dowolnego typu interfejsu użytkownika – od podstawowych układów po złożone animacje. Komponenty działają od razu, ale można je też dostosowywać i stylizować, aby pasowały do potrzeb aplikacji.
- Uproszczone i przyspieszone tworzenie: Compose jest zgodny z istniejącym kodem i umożliwia programistom wydajniejsze tworzenie aplikacji przy użyciu mniejszej ilości kodu.
- Intuicyjność: Compose używa składni deklaratywnej, która umożliwia wprowadzanie zmian w interfejsie użytkownika, debugowanie, zrozumienie i sprawdzanie kodu.
Jeśli nie znasz pakietu narzędzi Jetpack Compose, zapoznaj się ze ścieżką Compose. Wiele zasad tworzenia aplikacji w Compose na urządzenia mobilne ma zastosowanie również w przypadku telewizorów. Więcej informacji o ogólnych zaletach deklaratywnego frameworka interfejsu użytkownika znajdziesz w artykule Dlaczego warto używać Compose. Więcej informacji znajdziesz też w repozytorium przykładów Compose for TV na GitHubie.
AI Prompt
Dowiedz się, jak dodać obsługę Androida TV
Ten prompt prosi o wskazówki dotyczące dodawania obsługi Androida TV do aplikacji za pomocą Jetpack Compose for TV zamiast Leanback.
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 na TV działa na telewizorach z Androidem w wersji 5.0 (poziom API 21) lub nowszej. Korzystanie z Compose na TV w wersji 1.0 wymaga bibliotek androidx.compose w wersji 1.3.0 i Kotlina 1.7.10.
Konfiguracja
Korzystanie z Jetpack Compose na Androida TV jest podobne do korzystania z Jetpack Compose w dowolnym innym projekcie aplikacji na Androida. Główna różnica polega na tym, że Compose na TV 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 na urządzenia inne 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 TV, dodaj zależności pakietu narzędzi Jetpack Compose do pliku build.gradle aplikacji w ten sposób:
Kotlin (build.gradle.kts)
dependencies {
val composeBom = platform("androidx.compose:compose-bom:2026.08.00")
implementation(composeBom)
// General compose dependencies.
implementation("androidx.activity:activity-compose:1.13.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")
}
Dynamiczny (build.gradle)
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2026.08.00')
implementation composeBom
// General compose dependencies.
implementation 'androidx.activity:activity-compose:1.13.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 Material Design na telewizory są przeznaczone do salonu i mają wyraźne wskaźniki ostrości oraz zachowanie przyjazne dla pilota. Szczegółowe informacje o tym, jak używać tych konkretnych komponentów, znajdziesz w przewodnikach projektowania interfejsu użytkownika na telewizory.
Aby korzystać z tych funkcji, używaj wersji interfejsów API na telewizory.
Chociaż technicznie można używać wersji mobilnej Compose Material, nie jest ona zoptymalizowana pod kątem unikalnego stylu interakcji na Androida TV. Ponadto mieszanie Material Design z Compose na TV może powodować nieoczekiwane działanie. Na przykład, ponieważ każda biblioteka ma własny obiekt MaterialTheme, w przypadku używania obu wersji kolory, typografia lub kształty mogą być niespójne.
W tej tabeli przedstawiamy różnice w zależnościach między telewizorami a urządzeniami mobilnymi:
| Zależność na telewizorze (androidx.tv.*) |
Porównanie | Zależność na urządzeniu mobilnym (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | zamiast | androidx.compose.material3:material3 |
Dodatkowe materiały
Przewodniki projektowania na telewizory
Omówienie komponentów na telewizory do tworzenia interfejsów użytkownika z linkami do odpowiednich materiałów dla programistów.Przykładowy katalog Material Design na telewizory
Aplikacja katalogowa, która pokazuje, jak implementować zasady Material Design za pomocą Compose na TV.Przykład JetStream
Aplikacja do odtwarzania strumieniowego multimediów, która pokazuje, jak używać Compose na telewizory z typową aplikacją Material Design i architekturą rzeczywistą.Wprowadzenie do Compose for TV
To ćwiczenie prowadzi przez proces tworzenia aplikacji odtwarzacza wideo z ekranem przeglądarki katalogu i ekranem szczegółów.
Więcej informacji
Zapoznaj się z tymi przewodnikami, aby dowiedzieć się, jak tworzyć świetne rozwiązania zoptymalizowane pod kątem telewizorów:
- Tworzenie przeglądarki katalogu
- Tworzenie ekranu szczegółów
- Tworzenie układów z możliwością przewijania