telewizor

Ta tabela zawiera listę wszystkich artefaktów w grupie androidx.tv.

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:

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

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

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

Prześlij opinię

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.

Nie ma informacji o wersji tego artefaktu.

Tv-Material

Wersja 1.1

Wersja 1.1.0

6 maja 2026 r.

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

Wersja 1.1.0-rc01

8 kwietnia 2026 r.

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

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 w wersji 2.0.0 lub nowszej (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() rozszerzeniem Paint.nativePaint, aby uniknąć ujawniania 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ń słowo FocusEnterExitScope.cancelFocus() na cancelFocusChange()(I89959)
• Parametry FocusProperties.enter i FocusProperties.exit zostały zastąpione odpowiednio parametrami 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 nieprawidłowe zarządzanie skupieniem uwagi w karuzeli (Ie508b721375)
• W przypadku powierzchni (nieinteraktywnej) implementacja jest prostsza niż w przypadku powierzchni interaktywnych. (I7ea545150)

Wersja 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 na 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 karty 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 lambda końcowego w języku Kotlin, 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 wartość MutableInteractionSource, zostały zaktualizowane tak, aby udostępniać wartość MutableInteractionSource z możliwością przypisania wartości null, która domyślnie ma wartość null. Nie ma tu żadnych zmian semantycznych: przekazanie wartości null oznacza, że nie chcesz podnosić MutableInteractionSource, a w razie potrzeby zostanie on utworzony w komponencie. Ustawienie wartości null pozwala niektórym komponentom nigdy nie przydzielać MutableInteractionSource, a innym 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 w przypadku 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 Surface nie powoduje już animacji między stanami (I436e794f)

Tv-Foundation

Wersja 1.0

Wersja 1.0.0

6 maja 2026 r.

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

Wersja 1.0.0-rc01

8 kwietnia 2026 r.

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

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 w wersji 2.0.0 lub nowszej (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 leniwej wersji układu na telewizorze, 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

Publikacja 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 wyświetlanie półprzezroczystej nakładki 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.

Publikacja 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)
• Synchronizacja rozwidlenia tv-foundation z compose-foundation. (I737c3, b/287011882)
• Przeciążenie LazyLayout zostało dodane, akceptuje ono lambdę LazyLayoutItemProvider, a nie zwykły obiekt, jak to było 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 TV Compose Material. (Id7275)
• Zmiana parametru scrimColor: Color na scrimBrush:Brush, aby umożliwić użytkownikom dodawanie gradientów do warstwy przyciemniającej. (I254d4)

Wersja 1.0.0-alpha08

26 lipca 2023 r.

Publikacja 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 do materiałów Compose na TV. (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.

Publikacja 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 za pomocą Modifier.animateEnterExit z AnimatedContentScope. (Ic038e)
• Połączone parametry color i contentColor jako colors w przypadku powierzchni reklamowej TV Material Surface. (Ie69eb)
• Wprowadzono funkcję RadioButton w Material Design na telewizory. (I08690)
• Wprowadzono funkcję Switch w Material Design na telewizory. (I45e29)
• Wprowadzono funkcję Checkbox w Material Design na telewizory. (I6a45a)
• Wprowadzono nieinteraktywną powierzchnię w Materialu TV. (Ic5f85)
• Ustawić wskazania jako wewnętrzne. (Ibff82)

Wersja 1.0.0-alpha06

19 kwietnia 2023 r.

Publikacja 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

• Dodanie implementacji kart Material 3 zoptymalizowanych 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 DPAD Wstecz, gdy jest zaznaczony element NavigationDrawer. (d654f4)

Wersja 1.0.0-alpha05

22 marca 2023 r.

Publikacja 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 do tv-material ze wskaźnikami takimi jak Border, Glow i Scale, których można używać do tworzenia komponentów wyraźnie wyróżniających 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.

Publikacja 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 zapewnić wyświetlenie całego elementu. (11d7e40)
• Dodaj możliwość dostosowywania kolorów kart w różnych stanach. (21b2925)
• Karuzela obsługuje teraz niestandardowe animacje przewijania ręcznego w przód i w tył. (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 błąd powodujący awarię wyszukiwania po zaznaczeniu, gdy TvLazyColumn zawiera pusty element TvLazyRow. (e11b4fe), (b/260299091)
• Modyfikator clickable działa teraz z ImmersiveList. (5dd5078), (b/263061052)
• Klawisz Wstecz jest teraz obsługiwany i używany do zamykania karuzeli z wyróżnionymi treściami. (84c138c)
• Karuzela nie traci ostrości przy wielokrotnym szybkim naciśnięciu klawisza. (799489f)
• Karuzela nie traci zaznaczenia przy długim naciśnięciu klawisza. (b2cf37e)
• Rozwiązano problem 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.

Publikacja 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.

Publikacja 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.

Publikacja 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ń telewizyjnych, w tym:

• Dodanie modyfikatora scrollableWithPivot, aby umożliwić kontenerom przewijania bez leniwego ładowania, takim jak Row, Column i Grid, przewijanie treści w taki sposób, aby element, na którym skupia się uwaga, 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 (Karuzela z wyróżnionymi treściami) na telewizor, który umożliwia użytkownikowi 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 zostanie zaznaczony, pierwszy element nie jest domyślnie zaznaczany.
• 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.