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 atrakcyjnych i funkcjonalnych interfejsów.
Oto niektóre zalety korzystania z Compose na telewizory:
- Elastyczność: za pomocą Compose możesz tworzyć dowolne typy interfejsu, od podstawowych 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 deweloperom 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 na urządzenia mobilne za pomocą Compose ma zastosowanie również w przypadku telewizorów. Więcej informacji o ogólnych zaletach deklaratywnego frameworka interfejsu znajdziesz w sekcji Dlaczego warto używać Compose. Więcej informacji znajdziesz też w repozytorium z przykładami Compose na GitHubie.
Prompt AI
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 interfejsu API 21) lub nowszej. Korzystanie z Compose na TV w wersji 1.0 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 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 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 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.09.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")
}
Groovy (build.gradle)
dependencies {
def composeBom = platform('androidx.compose:compose-bom:2026.09.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
Elementy interfejsu telewizora są przeznaczone do salonu i mają wyraźne wskaźniki ostrości oraz wygodne sterowanie pilotem. 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 Compose z komponentami Material Compose z Compose na TV może powodować nieoczekiwane zachowania. Na przykład każda biblioteka ma własny MaterialTheme obiekt, więc jeśli użyjesz obu wersji, kolory, typografia lub kształty mogą być niespójne.
W tabeli poniżej znajdziesz różnice w zależnościach między telewizorem a urządzeniem mobilnym:
| TV Dependency (androidx.tv.*) |
Porównanie | Mobile Dependency (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | zamiast | androidx.compose.material3:material3 |
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 materiałów dla deweloperów.Przykładowy katalog materiałów na telewizor
Aplikacja katalogu, która pokazuje, jak wdrożyć zasady Material Design za pomocą Compose na TV.Przykładowa aplikacja JetStream
Aplikacja do strumieniowania treści multimedialnych, która pokazuje, jak używać TV Compose w typowych aplikacjach Material i architekturze rzeczywistej.Wprowadzenie do Compose na telewizory
Te ćwiczenia z programowania pokazują, jak utworzyć aplikację 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 aplikacje zoptymalizowane pod kątem telewizorów:
- Tworzenie przeglądarki katalogu
- Tworzenie ekranu szczegółów
- Tworzenie układów z możliwością przewijania