Compose for TV to nowoczesne podejście do tworzenia interfejsów użytkownika na Androida TV. Compose for TV zapewnia wszystkie zalety Jetpacka Compose na Androida w przypadku aplikacji na telewizory, ułatwiając tworzenie atrakcyjnych i funkcjonalnych interfejsów użytkownika.
Oto kilka konkretnych zalet korzystania z Compose for TV:
- Elastyczność: za pomocą usługi Compose możesz tworzyć dowolny typ interfejsu użytkownika, od prostych układów po złożone animacje. Komponenty działają od razu po zainstalowaniu, ale można je też dostosować i spersonalizować, aby pasowały do potrzeb Twojej 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.
- Intuicyjna: usługa Compose używa deklaratywnej składni, która umożliwia wprowadzanie zmian w interfejsie, debugowanie, analizowanie i sprawdzanie kodu.
Jeśli nie wiesz, jak korzystać z narzędzi Jetpack Compose, zapoznaj się z ścieżką Compose. Wiele zasad programowania w Compose na urządzeniach mobilnych ma zastosowanie również do telewizorów. Więcej informacji o ogólnych zaletach deklaratywnego frameworku UI znajdziesz w artykule Dlaczego warto używać Compose. Więcej informacji znajdziesz w repozytorium przykładowych aplikacji Compose for TV na GitHubie.
Prompt AI
Dowiedz się, jak dodać obsługę Androida TV
Ten komunikat zawiera wskazówki dotyczące dodawania obsługi Androida TV w 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ść
Funkcja tworzenia na telewizorach z Androidem działa na telewizorach z Androidem w wersji 5.0 (poziom API 21) lub nowszej. Korzystanie z wersji 1.0 Compose na telewizory wymaga bibliotek androidx.compose w wersji 1.3.0 oraz Kotlina w wersji 1.7.10.
Konfiguracja
Korzystanie z Jetpack Compose na Androidzie TV jest podobne do korzystania z Jetpack Compose w przypadku każdego innego projektu na Androida. Główna różnica polega na tym, że Compose for TV dodaje biblioteki, które zawierają 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ą tę samą nazwę co ich odpowiedniki przeznaczone do innych urządzeń, np. androidx.tv.material3.Button i androidx.compose.material3.Button.
Zależności pakietu narzędzi Jetpack Compose
Aby używać Compose na telewizorach, dodaj zależności pakietu Jetpack Compose do pliku build.gradle aplikacji w ten sposób:
Kotlin
dependencies { val composeBom = platform("androidx.compose:compose-bom:2024.12.01") implementation(composeBom) // General compose dependencies. implementation("androidx.activity:activity-compose:1.9.2") 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
dependencies { def composeBom = platform('androidx.compose:compose-bom:2024.12.01') implementation composeBom // General compose dependencies. implementation 'androidx.activity:activity-compose:1.9.2' 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 materiałów wideo są zaprojektowane z myślą o salonie i zawierają wskaźniki skupienia uwagi oraz elementy sterowania dostosowane do korzystania z pilota. Szczegółowe informacje o używaniu tych komponentów znajdziesz w przewodnikach po projektowaniu interfejsu użytkownika na telewizorze.
W miarę możliwości używaj wersji interfejsów API na telewizory, aby korzystać z tych funkcji.
Chociaż technicznie można używać wersji mobilnej interfejsu Compose Material, nie jest ona zoptymalizowana pod kątem unikalnego stylu interakcji na Androidzie TV. Ponadto łączenie komponentów z komponentów z Compose for TV może powodować nieoczekiwane działanie. Ponieważ każda biblioteka ma swój obiekt MaterialTheme, w przypadku użycia obu wersji może dojść do niezgodności w kolorach, typografii lub kształtach.
W tabeli poniżej przedstawiono różnice w zależnościach między wersjami na telewizory i na urządzenia mobilne:
| Uzależnienie od TV (androidx.tv.*) |
Porównanie | Zależność mobilna (androidx.compose.*) |
|---|---|---|
| androidx.tv:tv-material | zamiast | androidx.compose.material3:material3 |
Dodatkowe materiały
Przewodniki po projektowaniu aplikacji na telewizory
Omówienie specjalnych komponentów na telewizory do tworzenia interfejsów użytkownika wraz z linkami do odpowiednich materiałów dla programistów.Przykład katalogu Material Design na telewizory
Aplikacja katalogu, która pokazuje, jak stosować zasady Material Design za pomocą Compose na telewizory.Przykład JetStream
Aplikacja do strumieniowego przesyłania multimediów, która demonstruje użycie TV Compose w typowej aplikacji Material Design i w rzeczywistej architekturze.Wprowadzenie do tworzenia aplikacji na telewizory
W tym ćwiczeniu z programowania krok po kroku opisujemy tworzenie aplikacji odtwarzacza wideo z ekranem przeglądarki katalogu i ekranem szczegółów.
Więcej materiałów
Zapoznaj się z tymi przewodnikami, aby dowiedzieć się więcej o tworzeniu świetnych aplikacji zoptymalizowanych pod kątem telewizorów: