tv

  
Udostępnia programistom funkcje Compose i Material Design, które umożliwiają pisanie aplikacji na telewizory.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
11 marca 2026 r. 1.0.1 - 1.1.0-beta01 -

Deklarowanie zależności

Aby dodać zależności od tv-foundation i tv-material, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-beta01"
    implementation "androidx.tv:tv-material:1.1.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-beta01")
    implementation("androidx.tv:tv-material:1.1.0-beta01")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Brak informacji o wersji tego artefaktu.

Tv-Material Version 1.1

Wersja 1.1.0-beta01

11 marca 2026 r.

Publikacja androidx.tv:tv-material:1.1.0-beta01 Wersja 1.1.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Projekty wydane w Kotlinie 2.0 wymagają używania KGP 2.0.0 lub nowszego (Idb6b5, b/344563182).

Wkład zewnętrzny

  • androidx.compose.ui.graphics.NativePaint typealias został wycofany. Zamiast niego używaj bezpośrednio android.graphics.Paint (I6303c, b/477394763)
  • Zastąp rozszerzenie Paint.asFrameworkPaint() na Paint.nativePaint, aby uniknąć ujawnienia typu platformy w commonMain sourceset za pomocą typealias (I6303c, b/477394763)

Wersja 1.1.0-alpha01

15 stycznia 2025 r.

Publikacja androidx.tv:tv-material:1.1.0-alpha01 Wersja 1.1.0-alpha01 zawiera te zmiany.

Zmiany w interfejsie API

  • Zmień FocusEnterExitScope.cancelFocus() na cancelFocusChange()(I89959)
  • FocusProperties.enter i FocusProperties.exit zostały zastąpione odpowiednio przez onEnter i onExit, które używają zakresu odbiorcy zamiast parametru FocusDirection. (I6e667)

Poprawki błędów

  • Przeniesiono CompositingStrategy.OffScreen z powierzchni do tekstu, aby naprawić drgania tekstu podczas skalowania. (I92b15f17)
  • Naprawiono uszkodzone zarządzanie skupieniem uwagi w karuzeli (Ie508b721375)
  • W przypadku powierzchni (nieinteraktywnej) implementacja jest prostsza niż w przypadku powierzchni interaktywnych. (I7ea545150)

Tv-Material Version 1.0

Wersja 1.0.1

16 lipca 2025 r.

Publikacja androidx.tv:tv-material:1.0.1 Wersja 1.0.1 zawiera te zmiany.

Poprawki błędów

  • Zaktualizowano wysokość NavigationDrawerItem, aby była zgodna ze specyfikacją. (cf9a3ce)
  • Przeniesiono konfigurację strategii kompozycji z funkcji kompozycyjnej Surface do funkcji kompozycyjnej Text. Rozwiązuje to problem, w którym odtwarzacz ExoPlayer nie renderował się w komponentach Surface w starszych wersjach interfejsu API Androida. (9858ffb)

Wersja 1.0.0

21 sierpnia 2024 r.

Publikacja androidx.tv:tv-material:1.0.0 Wersja 1.0.0 to pierwsza stabilna wersja androidx.tv:tv-material.

Wersja 1.0.0-rc02

7 sierpnia 2024 r.

Publikacja androidx.tv:tv-material:1.0.0-rc02 Wersja 1.0.0-rc02 zawiera te zmiany.

Poprawki błędów

  • Naprawiliśmy drgania animacji tekstu w komponowalnym elemencie Surface. (3163319)

Wersja 1.0.0-rc01

10 lipca 2024 r.

Publikacja androidx.tv:tv-material:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zmiany.

Wersja 1.0.0-beta01

1 maja 2024 r.

Publikacja androidx.tv:tv-material:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Interfejs ColorScheme i jego funkcje narzędziowe są już stabilne. (If34fa)
  • LocalContentColor jest teraz stabilny (I60ee2)
  • Typography Interfejs API jest już stabilny (I088d6)
  • Interfejsy API kształtów są teraz stabilne (I0f5f4)
  • Interfejs Border API jest już stabilny (I69281)
  • Interfejs Glow API jest już stabilny (Iea5f1)
  • Komponent ikony jest już stabilny (I62c2d)
  • LocalTextStyles Interfejs API jest już stabilny (Iaded8)
  • MaterialTheme Interfejs API jest już stabilny (I2f541)
  • Komponent tekstowy jest teraz stabilny (Ib9e31)
  • Komponent RadioButton jest teraz stabilny (Ia03c8)
  • Komponent przełącznika jest teraz stabilny (I6cea3)
  • Komponenty Checkbox są teraz stabilne (I7eafc)
  • Komponenty interfejsu są teraz stabilne (I58758, I04aca)
  • Zmiana nazwy NonInteractiveSurfaceDefaults na SurfaceDefaults i NonInteractiveSurfaceColors na SurfaceColors (I0812e)
  • W przypadku platformy Selectable Surface używamy teraz terminu „wybierz” zamiast „zaznacz”, ponieważ mają one różne znaczenia (I5a206).
  • NavigationDrawer i NavigationDrawerScope są teraz stabilne (I249c1)
  • Komponent NavigationDrawerItem jest teraz stabilny (Id6986)
  • Komponenty Tab i TabRow są teraz stabilne (I92d92)
  • Komponenty Button, OutlinedButton, IconButton, OutlinedIconButton i WideButton są już stabilne (Ib4de8)
  • Komponenty Card, ClassicCard, CompactCard, WideClassicCard, StandardCardContainer i WideCardContainer są już stabilne (I34390)
  • Zmieniono nazwę StandardCardLayout na StandardCardContainer i WideCardLayout na WideCardContainer (I08883)
  • Usunięto element CardContainerDefaults.ImageCard i zmieniono nazwę elementu CardDefaults.ContainerGradient na CardDefaults.ScrimBrush (I6adfe). W kontenerach kart możesz używać Card zamiast CardContainerDefaults.ImageCard.
  • ListItem i DenseListItem są teraz stabilne (Idebd9)
  • ListItemDefaults.ListItemShape, ListItemDefaults.FocusedDisabledBorder i ListItemDefaults.SelectedContainerColorOpacity są teraz prywatne (I5d533)
  • Zmieniliśmy kolejność parametrów ListItem i zmieniliśmy nazwę parametru ListItemDefaults.ListItemElevation na ListItemDefaults.TonalElevation (Id6841). Parametr headlineContent został przeniesiony na górę funkcji kompozycyjnej. Wcześniej można było używać składni lambdy końcowej w Kotlinie, aby przekazywać headlineContent. Teraz musisz użyć składni nazwanego parametru, aby podać wartość headlineContent.
  • LocalAbsoluteTonalElevation jest teraz wewnętrzny (Ibfc65)
  • Komponent ImmersiveList został usunięty. Aby dowiedzieć się, jak to zrobić, zapoznaj się z tym przykładem. (Id48da)
  • Komponenty tv-material, które w swoim interfejsie API udostępniały MutableInteractionSource, zostały zaktualizowane, aby udostępniać MutableInteractionSource z możliwością wartości null, która domyślnie ma wartość null. Nie ma tu żadnych zmian semantycznych: przekazanie wartości null oznacza, że nie chcesz przenosić elementu MutableInteractionSource, a w razie potrzeby zostanie on utworzony w komponencie. Ustawienie wartości null pozwala niektórym komponentom nigdy nie przydzielać MutableInteractionSource, a innym komponentom tworzyć instancję tylko wtedy, gdy jest to potrzebne, co zwiększa wydajność tych komponentów. Jeśli nie używasz elementu MutableInteractionSource przekazywanego do tych komponentów, zalecamy przekazywanie zamiast niego wartości null. Zalecamy też wprowadzenie podobnych zmian we własnych komponentach. (I309b4, b/298048146)
  • Parametr TextAlign komponentu TV Text nie może już mieć wartości null (Ib73b1, b/299490814)
  • Wprowadziliśmy specjalną wartość „Nieokreślono” w polach TextAlign, TextDirection, Hyphens i LineBreak w ParagraphTextStyle, aby zastąpić (I4197e, b/299490814)

Zmiany w działaniu

  • Wartość domyślna parametru shape dla nieinteraktywnych Surface została zmieniona na RectangleShape (I1b859cb)
  • Niektóre funkcje karuzeli zostały wycofane w wersji beta, ponieważ niezbędne interfejsy API są eksperymentalne (I0e755d4).
  • Zmiana wartości contentColor w przypadku elementu Surface nie powoduje już animacji między stanami (I436e794f)

Wersja 1.0.0

Wersja 1.0.0-beta01

11 marca 2026 r.

Publikacja androidx.tv:tv-foundation:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zmiany.

Zmiany w interfejsie API

  • Projekty wydane w Kotlinie 2.0 wymagają używania KGP 2.0.0 lub nowszego (Idb6b5, b/344563182).

Wersja 1.0.0-alpha12

15 stycznia 2025 r.

Publikacja androidx.tv:tv-foundation:1.0.0-alpha12 Wersja 1.0.0-alpha12 zawiera te zmiany.

Zmiany w interfejsie API

  • Usuwanie leniwych układów z tv-foundation. Aby przeprowadzić migrację z leniwych układów tv-foundation, zapoznaj się z informacjami o wersji 1.0.0-alpha11. (I2fdd3, b/358913893)

Wersja 1.0.0-alpha11

10 lipca 2024 r.

Publikacja androidx.tv:tv-foundation:1.0.0-alpha11 Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

  • Funkcja Tv Lazy Layouts została wycofana z biblioteki tv-foundation. Aby dowiedzieć się, jak zrezygnować z leniwych układów na telewizorach, zapoznaj się z tym zgłoszeniem. (I0855f, b/332674072)
  • PlatformImeOptions jest teraz klasą konkretną, a nie interfejsem. (If40a4)

Wersja 1.0.0-alpha10

4 października 2023 roku

Publikacje androidx.tv:tv-foundation:1.0.0-alpha10 i androidx.tv:tv-material:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Nowe funkcje

  • Wprowadzono NavigationDrawerItem do użytku w NavigationDrawer i ModalNavigationDrawer. (I4b491)
  • Dodaj profil podstawowy do biblioteki tv-foundation. (2b57fd7)
  • Dodaj profil podstawowy do biblioteki tv-material. (1711ff5)

Zmiany w interfejsie API

  • Zmieniono nazwę NavigationDrawerScope.doesTabRowHaveFocus na NavigationDrawerScope.hasFocus. (I8286b)
  • Zmieniono nazwę TabRowScope.isActivated na TabRowScope.hasFocus. (Ic4273)

Poprawki błędów

  • Poprawia zgodność karuzeli z sąsiednimi elementami, które korzystają z interfejsów API przywracania fokusu. (7b2a7a4)
  • Wyłącz wskaźnik świecenia dla API_LEVEL poniżej 28, ponieważ nie jest on obsługiwany przez system operacyjny. (6d3616f)
  • Naprawiono błąd ANR spowodowany nieprawidłowym umieszczeniem elementu w kontenerach ładowanych na żądanie podczas szybkiego przewijania w kierunku przeciwnym. (642d65c)
  • Usunięto dopełnienie tła w panelu nawigacyjnym okna modalnego. (69965b2)
  • Poprawiono rysowanie warstwy przyciemniającej w panelu nawigacji, aby była rysowana nad treścią w tle, a nie za nią. (d4bbefb)

Wersja 1.0.0-alpha09

6 września 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha09 i androidx.tv:tv-material:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodaj interfejs ReusableComposition do zarządzania cyklem życia i ponownym wykorzystywaniem podkompozycji. (I812d1, b/252846775)
  • Zsynchronizuj fork tv-foundation z compose-foundation. (I737c3, b/287011882)
  • Przeciążenie LazyLayout akceptuje teraz lambdę LazyLayoutItemProvider, a nie zwykły obiekt, jak wcześniej. Poprzednie przeciążenie zostało wycofane. (I42a5a)
  • Dodaj TvKeyboardAlignment, aby umożliwić deweloperowi skonfigurowanie pozycji klawiatury ekranowej za pomocą AndroidImeOptions. (Idb772)
  • Dodaj rememberCarouselState, aby zapamiętać CarouselState za pomocą Saver w komponencie TV Compose Material. (Id7275)
  • Zmiana parametru scrimColor: Color na scrimBrush:Brush, aby umożliwić użytkownikom dodawanie gradientów do warstwy. (I254d4)

Wersja 1.0.0-alpha08

26 lipca 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha08 i androidx.tv:tv-material:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

  • Wprowadzenie komponentów Chip w bibliotece Compose for TV Material. (I86da4)
  • Dodaj komponent ListItem do materiału TV Compose. (I3f0b3)
  • Dodaj komponent DenseListItem do materiału TV Compose. (I536bf)

Zmiany w interfejsie API

  • Oznaczyliśmy publiczne interfejsy API materiałów telewizyjnych jako eksperymentalne. (I632e7)
  • Wprowadzono TabRowScope, aby udostępniać stan z funkcji kompozycyjnej TabRow funkcji kompozycyjnej Tab, i zmieniono nazwy właściwości TabColors. (Ief587)

Wersja 1.0.0-alpha07

7 czerwca 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha07 i androidx.tv:tv-material:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wskazania skali komponentów obejmują teraz opcję Brak, która umożliwia wyłączenie skalowania. (I50df5)
  • Dodano obsługę długiego kliknięcia w przypadku powierzchni Material Surface, kart i przycisków na telewizorze. (Id2b89)
  • Usunięto elementy CarouselItem i CarouselScope. Animację treści na pierwszym planie można uzyskać na slajdzie, używając Modifier.animateEnterExit z AnimatedContentScope. (Ic038e)
  • Połączone parametry color i contentColor jako colors w przypadku powierzchni reklamowych w telewizji. (Ie69eb)
  • Wprowadzono komponent RadioButton w Material Design na telewizory. (I08690)
  • Wprowadzono komponent Switch w Material Design na telewizory. (I45e29)
  • Wprowadzono komponent Checkbox w Material Design na telewizory. (I6a45a)
  • Wprowadzono nieinteraktywną powierzchnię w materiale TV. (Ic5f85)
  • Ustawić wskazania jako wewnętrzne. (Ibff82)

Wersja 1.0.0-alpha06

19 kwietnia 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha06 i androidx.tv:tv-material:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano implementacje kart Material 3 zoptymalizowane pod kątem telewizorów.
    • Karta podstawowa (I5b701)
    • ClassicCard, CompactCard i WideClassicCard (I70471)
    • StandardCardLayout i WideCardLayout (I33fae)
  • Dodaj implementacje przycisków Material 3 zoptymalizowane pod kątem telewizorów.
    • Podstawowy przycisk (I69c11)
    • IconButton i OutlinedIconButton (Ib504c)
    • WideButton (I4cecf)

Zmiany w interfejsie API

  • Zmieniono nazwy CarouselSlide i slideCount w Carousel na CarouselItem i itemCount. (Ie554c)
  • Zmieniono nazwy forward i backward ContentTransforms na StartToEnd i EndToStart. (Ie554c)

Poprawki błędów

  • Obsługa przycisku Wstecz na padzie kierunkowym, gdy jest zaznaczony element NavigationDrawer. (d654f4)

Wersja 1.0.0-alpha05

22 marca 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha05 i androidx.tv:tv-material:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Wprowadzamy komponent Side Navigation Drawer, który można umieścić w tv-material. Aby dowiedzieć się, jak korzystać z tego komponentu, zapoznaj się z przykładami. (I12c08)
  • Wprowadzenie komponentu Icon w bibliotece TV Material 3 (I72db9)
  • Wprowadzamy komponent Surface, który można łączyć z tv-material, z takimi wskazówkami jak Border, Glow i Scale. Można ich używać do tworzenia komponentów, które wyraźnie wyróżniają element, na którym skupia się uwaga na ekranie telewizora. (I4a6d8), (Iceea1), (Iee4d4), (I79edf), (Icb376)
  • Zaktualizuj CarouselItem na CarouselSlide, aby dopasować nazwę parametru slideCount w interfejsie API „Karuzela” (Ic4299)

Wersja 1.0.0-alpha04

8 lutego 2023 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha04 i androidx.tv:tv-material:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zatwierdzenia.

Nowe funkcje

  • W przypadku leniwych wierszy, kolumn i siatek punkt obrotu jest w razie potrzeby zastępowany, aby cały element był widoczny. (11d7e40)
  • Dodaj możliwość dostosowywania kolorów kart w różnych stanach. (21b2925)
  • Karuzela obsługuje teraz niestandardowe animacje przewijania do przodu i do tyłu. (431494a)

Zmiany w interfejsie API

  • Zmiana nazwy androidx.tv.material na androidx.tv.material3 i spłaszczenie struktury pakietu w androidx.tv.material3. (I6ca52)
  • Wskaźnik w wierszu wskaźnika karuzeli jest teraz miejscem, które deweloper może dostosować. (268af2a)
  • Zmieniono nazwę focusableItem na immersiveListItem. Użytkownicy będą musieli ręcznie dodać modyfikator focusable() lub clickable() wraz z immersiveListItem (5dd5078)(b/263061052).
  • Zmieniono nazwę timeToDisplayMillis na autoScrollDurationMillis w komponencie Karuzela. (431494a)
  • Usługa CarouselItem jest teraz ograniczona do użytku w Carousel. (431494a)
  • Karuzela akceptuje teraz ContentTransforms jako definicję animacji zamiast EnterTransition i ExitTransitions. (431494a)
  • Wprowadzono interfejs API PinnableContainer propagowany przez leniwe listy za pomocą lokalnego komponentu, który umożliwia przypinanie bieżącego elementu. (Ib8881, b/259274257, b/195049010)
  • Dodano właściwość mainAxisItemSpacing do TvLazyListLayoutInfo i TvLazyGridLayoutInfo (I37765)

Poprawki błędów

  • Zaktualizuj wiersz kart, aby prawidłowo obsługiwał liczbę kart równą 0 lub 1. (I44009), (1c01525), (b/264018028)
  • Naprawiono awarię wyszukiwania po zaznaczeniu, gdy TvLazyColumn zawiera pusty element TvLazyRow. (e11b4fe), (b/260299091)
  • Modyfikator clickable działa teraz z ImmersiveList. (5dd5078), (b/263061052)
  • Przycisk Wstecz jest teraz obsługiwany i używany do zamykania karuzeli z wyróżnionymi treściami. (84c138c)
  • Karuzela nie traci fokusu przy wielokrotnym szybkim naciśnięciu klawisza. (799489f)
  • Karuzela nie traci zaznaczenia przy długim naciśnięciu klawisza. (b2cf37e)
  • Rozwiązano problemy z awariami, które występowały, gdy zmieniała się liczba slajdów w karuzeli. (b261247)

Wersja 1.0.0-alpha03

7 grudnia 2022 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha03 i androidx.tv:tv-material:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Nowe funkcje

  • TabRow jest teraz dostępny jako eksperymentalny interfejs API, który umożliwia dodawanie do aplikacji górnych pasków nawigacyjnych. Zazwyczaj urządzenia TV oczekują, że karty będą się wczytywać, gdy tytuł karty jest zaznaczony w wierszu kart.
  • Wskaźniki specyficzne dla telewizora, takie jak wskaźnik podkreślenia i wskaźnik w formie pigułki, są dostępne od razu. Przykłady użycia znajdziesz w tv-samples.

Wersja 1.0.0-alpha02

9 listopada 2022 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha02 i androidx.tv:tv-material:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Poprawki błędów

  • Poprawiono wydajność przewijania kolekcji TvLazyRows/TvLazyColumns przez zmniejszenie przestrzeni wyszukiwania fokusu.(I723a3)

Wersja 1.0.0-alpha01

5 października 2022 r.

Publikacje androidx.tv:tv-foundation:1.0.0-alpha01 i androidx.tv:tv-material:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

Pierwsza wersja alfa zawiera wczesne implementacje komponentów do zastosowań na telewizorach, w tym:

  • Dodanie modyfikatora scrollableWithPivot, aby umożliwić kontenerom przewijania bez leniwego przewijania, takim jak Row, Column i Grid, przewijanie treści w taki sposób, aby element w fokusie pozostawał w tym samym miejscu na ekranie telewizora.
  • Dodanie funkcji kompozycyjnych TvLazyRow, TvLazyColumn, TvLazyHorizontalGrid, TvLazyVerticalGrid, aby kontener przewijania przewijał treści tak, aby element w centrum uwagi pozostawał w tym samym miejscu na ekranie telewizora.
  • Dodanie komponentu Featured Carousel, który umożliwia tworzenie automatycznie przewijanej karuzeli banerów.
  • Dodanie komponentu Immersive List na telewizory, który umożliwia użytkownikowi utworzenie wciągającego wiersza, kolumny lub siatki, w których tło zmienia się w zależności od elementu listy, na którym skupia się uwaga.

Znane problemy

  • Gdy kontener przewijania zyskuje fokus, pierwszy element nie zyskuje go domyślnie.
  • Skupienie się na TextField nie zawsze powoduje otwarcie klawiatury lub może uniemożliwić przeniesienie fokusu na inne pola.
  • Przewijanie w pionie w elemencie LazyColumn zawierającym element LazyRows działa słabo.