Korzystanie z Jetpack Compose na Androidzie TV

Compose for TV to nowoczesne podejście do tworzenia interfejsów Androida TV. Funkcja tworzenia wiadomości na telewizory pozwala korzystać ze wszystkich zalet Jetpack Compose na Androida w przypadku aplikacji na telewizory, dzięki czemu tworzenie atrakcyjnych i funkcjonalnych interfejsów użytkownika aplikacji jest znacznie łatwiejsze.

Oto niektóre zalety korzystania z funkcji Utwórz na telewizorze:

• Elastyczność: w interfejsie tej funkcji możesz tworzyć dowolny interfejs użytkownika, od prostych układów po złożone animacje. Komponenty działają od razu, ale można je też dostosowywać do potrzeb aplikacji.
• Uproszczone i przyspieszone programowanie: funkcja Compose jest zgodna z dotychczasowym kodem i umożliwia deweloperom wydajniejsze tworzenie aplikacji przy użyciu mniejszej liczby kodów.
• Intuicyjna: funkcja tworzenia wiadomości używa składni deklaratywnej, która umożliwia wprowadzanie zmian w interfejsie, debugowanie, analizowanie i sprawdzanie kodu.

Jeśli nie wiesz, jak korzystać z zestawu narzędzi Jetpack Compose, zapoznaj się ze ścieżką tworzenia wiadomości. Wiele zasad tworzenia aplikacji na komórki dotyczy również telewizji. Więcej informacji o ogólnych zaletach deklaratywnej platformy interfejsu znajdziesz w artykule Dlaczego warto tworzyć. Więcej informacji znajdziesz w repozytorium Compose for TV na GitHubie.

Zgodność

Funkcja tworzenia wiadomości na telewizorze działa na telewizorach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. Korzystanie z Compose for TV w wersji 1.0 wymaga wersji 1.3.0 bibliotek androidx.compose i Kotlin 1.7.10.

Konfiguruj

Korzystanie z Jetpack Compose na Androidzie TV przypomina korzystanie z Jetpack Compose w przypadku innych projektów na Androida. Główna różnica polega na tym, że Compose na telewizory dodaje biblioteki, które zawierają komponenty zoptymalizowane pod kątem telewizji, i ułatwiają tworzenie interfejsów użytkownika dostosowanych do telewizora. W niektórych przypadkach te komponenty mają taką samą nazwę jak ich odpowiedniki inne niż telewizyjne, np. androidx.tv.material3.Button i androidx.compose.material3.Button.

Zależności zestawu narzędzi Jetpack Compose

Aby korzystać z funkcji Compose for TV, dołącz 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:2024.06.00")
   implementation(composeBom)

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

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

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

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

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

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

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

Co się zmieniło

Gdy tylko jest to możliwe, używaj telewizyjnej wersji interfejsów API. Chociaż pod względem technicznym korzystanie z wersji Compose Material dla urządzeń mobilnych jest możliwe, nie jest ona zoptymalizowana pod kątem tego wyjątkowego stylu interakcji na Androidzie TV. Poza tym połączenie elementu Compose Material z komponentem Compose for TV może spowodować nieoczekiwane działanie. Na przykład każda biblioteka ma własny obiekt MaterialTheme, więc kolory, typografia lub kształty mogą być niespójne w przypadku użycia obu wersji.

W tej tabeli przedstawiamy różnice między telewizorami a urządzeniami mobilnymi:

Dodatkowe materiały

• Przykładowy katalog Material Design
  Aplikacja z katalogiem pokazująca, jak wdrożyć zasady Material Design w usłudze Compose na telewizory.

• Przykładowa aplikacja JetStream
  Aplikacja do strumieniowego odtwarzania multimediów, która przedstawia użycie TV Compose z typową aplikacją Material i architekturą z życia codziennego.

• Wprowadzenie do Compose na telewizory
  Ćwiczenie z programowania obejmuje 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ę, jak tworzyć doskonałe reklamy z myślą o telewizji dla:

• Ekran przeglądania katalogu
• Ekran ze szczegółami