Karty na Wear

tworzyć aplikacje na zegarki z Wear OS by Google.
Ostatnia aktualizacja Wersja stabilna Kandydat do wydania Wersja Beta Wersja alfa
30 października 2024 r. 1.4.1 - - 1.5.0-alpha03

Deklarowanie zależności

Aby dodać zależność od Wear, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Google Maven.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Odlotowe

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0-alpha03"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0-alpha03"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0-alpha03"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0-alpha03"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0-alpha03"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0-alpha03"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0-alpha03")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0-alpha03")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0-alpha03")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0-alpha03")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0-alpha03")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0-alpha03")
}

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 zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową bibliotekę, przejrzyj istniejące problemy w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

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

Wersja 1.5

Wersja 1.5.0-alpha03

30 października 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha03 został zwolniony. Wersja 1.5.0-alpha03 zawiera te komity.

Wersja 1.5.0-alpha02

16 października 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.5.0-alpha02 została zwolniona. Wersja 1.5.0-alfa02 zawiera te zatwierdzenia.

Poprawki dotyczące bezpieczeństwa

  • Od momentu wprowadzenia tej zmiany androidx kompiluje się z użyciem protobuf 4.28.2, aby rozwiązać problem CVE-2024-7254. Aby rozwiązać problem z luką w zabezpieczeniach, zaktualizuj zależność od wersji androidx.wear.tiles:tiles-proto 1.5.0-alpha01 do wersji 1.5.0-alpha02.

Wersja 1.5.0-alpha01

2 października 2024 r.

androidx.wear.tiles:tiles-*:1.5.0-alpha01 został zwolniony. Wersja 1.5.0-alfa01 zawiera te zatwierdzenia.

Wersja 1.4

Wersja 1.4.1

16 października 2024 r.

androidx.wear.tiles:tiles-*:1.4.1 został zwolniony. Wersja 1.4.1 zawiera te komity.

Poprawki zabezpieczeń

  • Od momentu wprowadzenia tej zmiany androidx kompiluje się z użyciem protobuf 4.28.2, aby rozwiązać problem CVE-2024-7254. Uaktualnij zależność z androidx.wear.tiles:tiles-proto do wersji 1.4.0 do wersji 1.4.1, aby wyeliminować ryzyko luk w zabezpieczeniach.

Wersja 1.4.0

7 sierpnia 2024 r.

androidx.wear.tiles:tiles-*:1.4.0 został zwolniony. Wersja 1.4.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.3.0

  • Obsługa narzędzi do określania niestandardowych danych platformy na potrzeby podglądów kafelków w Android Studio.

Wersja 1.4.0-rc01

24 lipca 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-rc01 nie wprowadza żadnych zmian w porównaniu z poprzednią wersją. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Wersja 1.4.0-beta01

10 lipca 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-beta01 została zwolniona. Wersja 1.4.0-beta01 zawiera te komity.

Nowe funkcje

Wersja 1.4.0-beta01 pakietu Wear Tiles oznacza, że ta wersja biblioteki jest kompletna pod względem funkcji, a interfejs API jest zablokowany (z wyjątkiem wersji oznaczonych jako eksperymentalne). Wersja Wear Tiles 1.4 zawiera te nowe funkcje i interfejsy API:

  • Obsługa narzędzi do określania niestandardowych danych platformy na potrzeby podglądów kafelków w Android Studio.

Wersja 1.4.0-alpha05

26 czerwca 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha05 został zwolniony. Wersja 1.4.0-alpha05 zawiera te komisy.

Wersja 1.4.0-alpha04

29 maja 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha04 został zwolniony. Wersja 1.4.0-alfa04 zawiera te zatwierdzenia.

Wersja 1.4.0-alpha03

14 maja 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.4.0-alpha03 została zwolniona. Wersja 1.4.0-alfa03 zawiera te zatwierdzenia.

Poprawki błędów

  • Aby podawać dokładniejsze wyniki, TileService#getActiveTilesAsync używa teraz interfejsu API WearSdk (jeśli jest dostępny). (I57bd8)

Wersja 1.4.0-alpha02

1 maja 2024 r.

androidx.wear.tiles:tiles-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te komity.

Zmiany w interfejsie API

  • Przenieś element tileId do parametru konstruktora konstruktora jako pole obowiązkowe i wartość domyślnej sygnatury czasowej dokumentu w narzędziu pobierającym. (I98c2b)
  • Dodaj protokoły TileInteractionEvent, TileEnter i TileLeave oraz opakowania Java potrzebne do grupowania zdarzeń wejścia/wyjścia z kafelka. (I112b0)
  • Przerzuć TileRenderer, aby zamiast obiektu TileRenderer.Config używać obiektu Builder. (Ib66f9)
  • Dodaj atrybut platformDataProviders do TileRenderer.Config. (I6030d)
  • Dodaj do klasy TileRenderer nowy konstruktor obsługujący nową klasę TileRenderer.Config. Inne konstruktory są wycofane. (Iae7ff)
  • Dodaj pole platformDataValues do pola TilePreviewData, aby umożliwić zastąpienie wartości danych platformy. (If437a)

Poprawki błędów

  • Udokumentuj, że domyślną wartością parametru TileRenderer.Config.Builder#setTilesTheme jest 0. (Iced18)

Wersja 1.4.0-alpha01

6 marca 2024 roku

androidx.wear.tiles:tiles-*:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te komisy.

Wersja 1.3

Wersja 1.3.0

7 lutego 2024 r.

androidx.wear.tiles:tiles-*:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te commity.

Ważne zmiany wprowadzone od wersji 1.2.0

  • Zaktualizowano narzędzia do obsługi podglądu kafelków.
  • Obsługa zapytań dotyczących aktywnych kafelków należących do aplikacji.

Dodatkowe zmiany

Wersja 1.3.0-rc01

24 stycznia 2024 r.

androidx.wear.tiles:tiles-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

Zmiany w interfejsie API

  • Nazwa TileService#getActiveTilesSnapshotAsync została zmieniona na getActiveTilesAsync. (If6b87)

Wersja 1.3.0-beta01

10 stycznia 2024 r.

Usługa androidx.wear.tiles:tiles-*:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Wersja 1.3.0-beta01 pakietu Wear Tiles oznacza, że ta wersja biblioteki jest kompletna pod względem funkcji, a interfejs API jest zablokowany (z wyjątkiem wersji oznaczonych jako eksperymentalne). Interfejs Wear Tiles w wersji 1.3 zawiera te nowe funkcje i interfejsy API:

  • Moduł narzędzi do tworzenia kafelków na Wear OS został zaktualizowany, aby obsługiwać podgląd kafelków. Jest gotowy do opublikowania.
  • Obsługa zapytań o to, które karty należące do aplikacji są aktywne z użyciem TileService.getActiveTilesSnapshotAsync.

Wersja 1.3.0-alpha04

13 grudnia 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha04 został zwolniony. Wersja 1.3.0-alpha04 zawiera te commity.

Wersja 1.3.0-alfa03

29 listopada 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha03 został zwolniony. Wersja 1.3.0-alfa03 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nowy interfejs API TileService#getActiveTilesSnapshotAsync do zapytań o to, które elementy należące do aplikacji są aktywne. (I6850e)

Zmiany w interfejsie API

  • Zmień nazwę @TilePreview na @Preview (Ifc08a)

Wersja 1.3.0-alpha02

15 listopada 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha02 został zwolniony. Wersja 1.3.0-alpha02 zawiera te commity.

Nowe funkcje

  • Dodaliśmy eksperymentalny interfejs API, który automatycznie dostosowuje rozmiar tekstu do miejsca, jakie zajmuje w elemencie nadrzędnym. (Ibbe63)

Wersja 1.3.0-alpha01

18 października 2023 r.

androidx.wear.tiles:tiles-*:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

  • Prześlij kontekst jako parametr metody podglądu zamiast parametrów wywołania zwrotnego TilePreviewData. (I5e97d)
  • Moduł narzędzi do obsługi kafelków na Wear OS został zaktualizowany, aby obsługiwać podgląd kafelków. Jest gotowy do opublikowania. (I63d0f)

Wersja 1.2

Wersja 1.2.0

9 sierpnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

  • stabilna wersja Wear Tiles 1.2.0 (więcej informacji);
  • Wersja 1.2 zawiera obsługę wiązania elementów układu z danymi platformy (w celu szybszego aktualizowania) oraz animacji. Instrukcje dotyczące migracji znajdziesz w notatkach do wersji (1.2.0-rc01).

Wersja 1.2.0-rc01

26 lipca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

  • W wersji 1.2 biblioteka Tiles została przebudowana, a większość funkcji i interfejsów API została przeniesiona do nowej biblioteki ProtoLayout (pakiet androidx.wear.protolayout). Niewielka ich część pozostała w bibliotece Tiles (androidx.wear.tiles):

    • Wszystkie nazwy klas pozostały takie same. Jedyne, co można dodać do wersji 1.1, to zmiany.
    • Większość interfejsów API pozostała bez zmian, a jedyną zmianą jest nazwa pakietu.
    • Niektóre metody w bibliotece TileService/TileBuilder zostały wycofane i teraz mają zmienione nazwy, a zamiast wycofanych metod obsługiwane są nowe typy ProtoLayout.

  • Aby ułatwić Ci migrację, przygotowaliśmy krótkie instrukcje i skrypt, który przeprowadzi tę zmianę. Znajdziesz je tutaj.

Zmiany interfejsu API

  • Maksymalna głębia układu została ograniczona do 30 zagnieżdżonych elementów w płytce. Jeśli ta głębia zostanie przekroczona, renderowanie kafelków będzie wyświetlać wcześniej napompowany układ. (I8a74b)

Wersja 1.2.0-beta01

21 czerwca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-beta01 jest opublikowany bez wprowadzenia zmian. Wersja 1.2.0-beta01 zawiera te commity.

Wersja 1.2.0-alpha07

7 czerwca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha07 został zwolniony. Wersja 1.2.0-alpha07 zawiera te zatwierdzenia.

Nowe funkcje

  • TileRenderer.setState umożliwia ustawienie stanu sesji renderowania. Ten stan będzie obowiązywał w przypadku bieżącego i przyszłych układów (do czasu ustawienia nowego stanu) (Iaaf35)
  • Typy protolayout są teraz w pełni obsługiwane we wszystkich interfejsach API do renderowania kafelków. (I428b0)

Poprawki błędów

  • Ustawienie motywu niestandardowego jest teraz możliwe w sekcji ProtoLayoutViewInstance. (Iae8c0).

Wersja 1.2.0-alpha06

24 maja 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha06 został zwolniony. Wersja 1.2.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

  • Zmień nazwę StateEntryValue na DynamicDataValue i zaktualizuj interfejsy API stanu tak, aby używały DynamicDataKey (If1c01).
  • Ograniczamy liczbę wpisów dozwolonych w StateStore, aby zapewnić odpowiednią kontrolę i ograniczenie wykorzystania pamięci oraz czasu aktualizacji stanu w przypadku każdej instancji StateStore. W związku z tym deweloper musi zadbać o to, aby nie miał więcej niż MAX_STATE_ENTRY_COUNT wpisów na mapie. W przeciwnym razie podczas tworzenia lub aktualizowania elementu StateStore otrzyma wartość IllegalStateException. (Ibadb3)

Wersja 1.2.0-alpha05

10 maja 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha05 został zwolniony. Wersja 1.2.0-alfa05 zawiera te zatwierdzenia.

Nowe funkcje

  • Do zdarzeń i zapytań dotyczących kafelków dodaliśmy identyfikator kafelka. Ten identyfikator może służyć do powiązania niektórych danych z kartą w karuzeli. (Ic4f83)

Zmiany w interfejsie API

  • TileRenderer.inflateAsync zwraca teraz ListenableFuture. (I2f2b9)
  • Generatory kafelków, które mają zamienniki w bibliotece protolayout, są teraz oznaczone jako wycofane. (Ie2029)

Poprawki błędów

  • W dokumentacji javadoc dla metody TileService.onTileResourcesRequest wyjaśniono, kiedy system może ją wywołać. (Iee037).

Wersja 1.2.0-alpha04

19 kwietnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha04 został zwolniony. Wersja 1.2.0-alpha04 zawiera te commity.

Poprawki błędów

  • W razie potrzeby zależności Gradle są teraz prawidłowo ustawione na api zamiast implementation. (I40503)

Wersja 1.2.0-alpha03

5 kwietnia 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha03 został zwolniony. Wersja 1.2.0-alfa03 zawiera te zatwierdzenia.

Zmiany interfejsu API

  • Dodaliśmy obsługę typów androidx.wear.protolayout w funkcji TileRenderer (I4ac7f).
  • Nazwa ObservableStateStore została zmieniona na StateStore. (Ieb0e2).
  • Dodaj przeciążenia typów układu prototypowego do TileRenderer (I4ac7f)
  • Włączanie animacji w TileRenderer (I07dcf)

Wersja 1.2.0-alpha02

22 marca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

  • Biblioteka materiałów kafelków została wycofana. Użyj nowej biblioteki ProtoLayout Material, która ma te same funkcje. (If242b)

Poprawki błędów

  • Aplikacja TileRenderer została zaktualizowana, aby korzystać z nowych funkcji biblioteki protolayout. (I832f9)

Wersja 1.2.0-alpha01

8 marca 2023 r.

androidx.wear.tiles:tiles-*:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Nowe funkcje

  • Dodaliśmy do onTileResourceRequest rolę TileService, aby udostępniać zasoby z biblioteki protolayout. (983d9c5)
  • Zaktualizowaliśmy ResourcesRequest i TileRequest, by obsługiwać typy State i DeviceParameters z biblioteki protolayout. (88fa01d)
  • Zaktualizowaliśmy TileBuilders.Tile, aby obsługiwał typy State i Timeline z biblioteki protolayout. (168619c)

Poprawki błędów

  • Ulepszenia w dokumentacji Javadoc. (I3ed73)
  • Domyślne kolory usługi onPrimary i powierzchni uległy zmianie. (I0b039)

Wersja 1.1

Wersja 1.1.0

24 sierpnia 2022 r.

androidx.wear.tiles:tiles-*:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.0.0

  • Jest to pierwsza stabilna wersja zawierająca bibliotekę komponentów Tiles (więcej informacji znajdziesz na naszym blogu).
  • Ta biblioteka zawiera komponenty i układy, które są zgodne ze wskazówkami dotyczącymi materiałów i łatwe w użyciu. Uwzględnione komponenty to Button, Chip, CompactChip, TitleChip, CircularProgressIndicator i Text.Wszystkie te komponenty mają własne obiekty kolorów, które można utworzyć za pomocą głównej klasy Colors, aby łatwo zastosować ten sam motyw do wszystkich komponentów. Oprócz kolorów dostępna jest klasa Typography, która umożliwia łatwe pobieranie obiektów FontStyle za pomocą nazwy typografii.
  • Oprócz komponentów masz też zalecane układy kafelków: PrimaryLayout, EdgeContentLayout, MultiButtonLayout i MultiSlotLayout. Wszystkie układy mają zastosowane zalecane wartości wypełnienia i style zgodne ze wskazówkami Material Design.
  • Listę komponentów i schematów w bibliotece materiałów Płytki znajdziesz w informacjach o wersji Płytki.

Wersja 1.1.0-rc01

10 sierpnia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-rc01 została zwolniona. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

  • Nie wprowadzono żadnych nowych zmian między wersją beta a wersją RC.

Wersja 1.1.0-beta01

27 lipca 2022 roku

androidx.wear.tiles:tiles-*:1.1.0-beta01 został zwolniony. Wersja 1.1.0-beta01 zawiera te zatwierdzenia.

Wersja 1.0.0-beta01 biblioteki komponentów Tiles Material zawiera komponenty i układy, które są zgodne ze wskazówkami Material Design i łatwe w stworzeniu.

Dołączone komponenty:

  • Button – klikalny obiekt o okrągłym kształcie z ikoną, tekstem lub obrazem w 3 wstępnie zdefiniowanych rozmiarach.
  • Chip – klikalny obiekt w kształcie stadionu, który może zawierać ikonę oraz etykiety główną i dodatkową. Ma stałą wysokość i szerokość, którą można dostosować.
  • CompactChip i TitleChip – 2 warianty standardowego elementu Chip, które mają odpowiednio mniejszą i większą wysokość i mogą zawierać 1 wiersz tekstu.
  • CircularProgressIndicator – kolorowy łuk wokół krawędzi ekranu z podanymi kątami początkowymi i końcowymi, który może opisywać pełne lub częściowe koło z pełnym łukiem postępu.
  • Text – tekst sformatowany za pomocą zalecanych stylów typograficznych Wear Material

Wszystkie te komponenty mają własny obiekt kolorów, który można utworzyć za pomocą głównej klasy Colors, aby łatwo zastosować ten sam motyw do wszystkich komponentów. Oprócz kolorów istnieje klasa Typography, która umożliwia łatwe pobieranie obiektów FontStyle za pomocą nazwy typograficznej.

Oprócz komponentów masz też zalecane układy kafelków:

  • PrimaryLayout – układ, który można dostosować, dodając etykiety główne lub dodatkowe, treść na środku oraz element główny na dole. Główna treść w tym układzie może zostać dodana jako obiekt MultiSlotLayout lub MultiButtonLayout.
  • EdgeContentLayout – układ do umieszczenia elementu CircularProgressIndicator wzdłuż krawędzi, z treścią główną w środku oraz etykietą główną lub dodatkową.
  • MultiButtonLayout – układ, który może zawierać od 1 do 7 przycisków rozmieszczonych zgodnie z wytycznymi Material Design w zależności od ich liczby.
  • MultiSlotLayout – układ w postaci rzędów z wyrównanymi poziomo i rozstawionymi slotami (na ikony lub inne małe treści).

We wszystkich układach zastosowano zalecane dopełnienie i style zgodne z wytycznymi dotyczącymi materiałów.

Zmiany interfejsu API

  • Zważyj na refaktoryzację komponentów elementu, w tym rozdzielaj elementy ustawiające w Kreatorze, aby każda część treści była przekazywana oddzielnie, zmieniając jej nazwę zgodnie z wytycznymi (etykieta podstawowa, etykieta dodatkowa, identyfikator zasobu obrazu). Jeśli nie ustawisz opisu treści, zostanie on wygenerowany automatycznie. (I57622)
  • Nazwa ProgressIndicatorLayout została zmieniona na EdgeContentLayout. (Ic1aa6)
  • Treści dotyczące rozmiaru przycisku zostały przemianowane na nazwy z sufiksem without _BUTTON, a dodatkowe wyjaśnienia dotyczące Javadocs zostały dodane w całości Button. (I1dfe2)

Poprawki błędów

  • Marginesy, wypełnień i ogólnego układu w układach Material Design, aby pasowały do wszystkich typów zalecanych układów oraz rozmiarów i kształtów ekranu.
  • Ulepszenia układów Material. In MultiSlotLayout slots are now flexible in width where they’ll wrap content instead of being fixed size.(I52919),(If18b4)
  • Obszar, który można dotknąć CompactChip, został powiększony zgodnie ze wskazówkami dotyczącymi ułatwień dostępu. (Ie8264)

Wersja 1.1.0-alpha09

29 czerwca 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha09 została zwolniona. Wersja 1.1.0-alpha09 zawiera te commity.

Nowe funkcje

  • W usłudze ProgressIndicatorLayout dodaliśmy obsługę dodawania opcjonalnych etykiet. (I30788)

Zmiany w interfejsie API

  • Metody pomocnicze dla ElementMetadata przyjmują teraz ElementMetadata zamiast Modifiers. (I5a70f)

Poprawki błędów

  • W domenie CompactChip usunięto ograniczenie wynoszące 9 znaków. Jeśli tekst jest za duży, aby zmieścić się na ekranie w trybie PrimaryLayout, zostanie wydłużony. (Id56ec).
  • Metody dostępu w Chip mają teraz przyrostek Content. (Iba437)
  • Uszczegółowienie Javadoc w klasach Materiał płytki. (I56e41), (I80f31), (Iba437)

Wersja 1.1.0-alpha08

1 czerwca 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha08 został zwolniony. Wersja 1.1.0-alpha08 zawiera te commity.

Nowe funkcje

  • Do modyfikatorów dodano tag metadanych, który można wykorzystać do śledzenia metadanych komponentu za pomocą metod pomocniczych dodanych do klasy Helper. (I70db2),(I30c3d)
  • Do wszystkich komponentów i schematów w ramach komponentu Tiles Material dodano stałą metodę fromLayoutElement. Należy go używać do testowania, aby przekształcić element LayoutElement uzyskany z dostępu do zawartości kontenera w jego pierwotny typ. (Ia572a),(Idbd8a),(I3ae13),(I292fe),(I8b20f),(I3cacb),(I84b24)

Wersja 1.1.0-alpha07

18 maja 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha07 został zwolniony. Wersja 1.1.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

  • Do metod ProgressIndicatorLayout i PrimaryLayout dodaliśmy metody dostępu powiązane z różnymi metodami mutatora dla treści. Teraz wszystkie metody setter w tych klasach mają odpowiadające im metody getter (Iddbe5). (Iabe4e)
  • Getter dla opisu treści w Material Components może zwracać wartość null, ponieważ jego setter nie jest obowiązkowy.
  • Próba utworzenia przycisku bez przekazanych treści spowoduje błąd IllegalArgumentException. (I7fc0c)
  • Nazwa pól związanych z kolorami ikon w sekcji ChipColors została zmieniona z iconTintColor na iconColor. (Ic053b)

Poprawki błędów

  • Dodano androidTests dla układów w materiałach dotyczących kart. (I96404).

Wersja 1.1.0-alpha06

11 maja 2022 roku

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha06 została zwolniona. Wersja 1.1.0-alpha06 zawiera te commity.

Nowe funkcje

  • Nowy układ został dodany do podbiblioteki układów Material Design – MultiButtonLayout. Reprezentuje układ, który może zawierać od 1 do 7 przycisków rozmieszczonych zgodnie z wytycznymi Material Design. W większości przypadków ten układ powinien być przekazywany jako zawartość do elementu PrimaryLayout. (IB727f)

Zmiany w interfejsie API

  • MultiSlotLayout został przekształcony tak, aby zawierał tylko sloty. Ten układ należy przekazać jako treść do głównego panelu PrimaryLayout. (I1870f)
  • Zaktualizowano zdefiniowane kolory domyślne dla pola CircularProgressIndicator, tak aby zawierały tylko jedną wartość, zamiast koloru podstawowego i dodatkowego. (I64a51)
  • Dodano metodę pobierania dla poziomej spacji w elemencie MultiSlotLayout. (I11e1e).

Poprawki błędów

  • Testy komponentów na Androida zostały dodane do panelu Materiał kafelków. (I20041)

Wersja 1.1.0-alpha05

6 kwietnia 2022 roku

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha05 została zwolniona. Wersja 1.1.0-alpha05 zawiera te commity.

Nowe funkcje

  • Dodaliśmy pomocnicze metody do konwertowania LayoutElement na Layout, Timeline i TimelineEntry w tych klasach, aby ułatwić tworzenie kafelków. (I2f6d1)
  • Obiekt Colors został dodany do biblioteki Material Design, aby można go było przekazać między kolorami komponentów jako motyw. (I0792c)

Zmiany w interfejsie API

  • Komponent Tekst materiału wymaga tekstu przekazywanego do konstruktora. Ten komponent można teraz dostosować, ustawiając wagę. (I25dbd)
  • Usunięto stałe z ChipDefaults, które nie są używane w publicznych setterach. (I7Baed).
  • Usunięto z klas CompactChip i TitleChip metody getter, które nie mają odpowiednich metod setter. (I99e85)
  • Usunięto DEFAULT_PADDING z listy ProgressIndicatorDefaults. (Idabcd)
  • Komponenty Material Design teraz akceptują CharSequence jako opis treści zamiast ciągu znaków. (I5b21a)

Poprawki błędów

  • Zmieniono implementację metod settera opcjonalnych parametrów w przycisku. (Ib7135)
  • Do czcionek w sekcji Typografia dodaliśmy wariant stylu czcionki. (I8dbc6)

Wersja 1.1.0-alpha04

23 marca 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha04 został zwolniony. Wersja 1.1.0-alpha04 zawiera te commity.

Nowe funkcje

  • Opcjonalną etykietę podstawową lub dodatkową można dodać do pola PrimaryLayout. (Ib9916)
  • Komponent tekstowy można dostosować, ustawiając przepływ, kursywę, podkreślenie itp. (I703f7)

Zmiany w interfejsie API

  • Domyślne stałe kolorów zostały usunięte z interfejsu Tiles Material API. (I0Ab55)
  • Wszystkie klikalne komponenty w materiale kafelków wymagają obiektu Clickable w konstruktorze konstruktora, a nie działania. (I2f101)

Poprawki błędów

  • Tekst będzie teraz wyświetlany w postaci kropek w komponencie elementu tekstowego i elementu elementu tekstowego. (I8a2f8)
  • Ulepszony wygląd komponentów, gdy skala czcionki użytkownika jest ustawiona na dużą. (IB63b1)
  • Wyjaśnienie Javadocs setPrimaryChipContent w PrimaryLayout. (Ie6296)

Wersja 1.1.0-alfa03

23 lutego 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.1.0-alpha03 została zwolniona. Wersja 1.1.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

  • Do Materiału do tworzenia kafelków dodano komponent Text z zalecanymi stylami typograficznymi. (Iec0ae),

Wersja 1.1.0-alfa02

9 lutego 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha02 został zwolniony. Wersja 1.1.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

  • Dodano nową bibliotekę podrzędną layouts w panelu Materiał kafelków. Zawiera ona układy kafelków z zalecanym marginesem i odstępem, które ułatwiają i przyspieszają tworzenie kafelków. Początkowe układy:
    • PrimaryLayout (I7ba91), który przedstawia układ z głównym układem scalonym na dole i treściami w środku.
    • MultiSlotLayout (I32104) to układ z etykietami w wierszach 1 i 3, wyrównanymi poziomo i rozstawionymi slotami w wierszu 2. Za nimi znajduje się 4. wiersz z głównym elementem.
    • ProgressIndicatorLayout (I9fec6), który reprezentuje układ z okrągłym wskaźnikiem postępu wzdłuż krawędzi ekranu i wyświetlanymi treściami.
  • Do komponentów Material Tiles został dodany CircularProgressIndicator (Ic4b88).

Zmiany w interfejsie API

  • Zmieniono nazwy pozostałych stałych używanych przez TitleChip, aby uwzględnić tytuł w nazwie. (I14f4c)
  • Metoda setHorizontalAlignment została dodana do Chip. (Ie6e0b)

Wersja 1.1.0-alpha01

26 stycznia 2022 r.

androidx.wear.tiles:tiles-*:1.1.0-alpha01 został zwolniony. Wersja 1.1.0-alpha01 zawiera te commity.

Nowe funkcje

  • Dodano nowy materiał kafelki z biblioteki. Zawiera komponenty, które umożliwiają szybsze i prostsze tworzenie układów kafelków z użyciem projektu Material Design. Początkowe komponenty:
    • Button
    • Chip
    • CompactChip
    • TitleChip

Poprawki błędów

  • Naprawiono błąd w TileUiClient, który powodował odrzucanie zasobów z bufora. (I60e0b)

Wersja 1.0

Wersja 1.0.1

26 stycznia 2022 r.

Usługa androidx.wear.tiles:tiles-*:1.0.1 została zwolniona. Wersja 1.0.1 zawiera te zatwierdzenia.

Poprawki błędów

  • Naprawiono błąd w TileUiClient, który powodował odrzucanie zasobów z bufora. (I60e0b)

Wersja 1.0.0

3 listopada 2021 r.

androidx.wear.tiles:tiles-*:1.0.0 został zwolniony. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

  • Biblioteka Wear Tiles zawiera funkcje do tworzenia niestandardowych kafelków na urządzenia z Wear OS oraz klasy, które umożliwiają systemowi pobieranie kafelka i wyświetlanie go obok tarczy zegarka.
  • tiles-renderer umożliwia wyświetlanie kafelka w ramach aktywności Androida, co ułatwia szybkie testowanie układów.

Wersja 1.0.0-rc01

27 października 2021 roku

androidx.wear.tiles:tiles-*:1.0.0-rc01 został zwolniony. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Wersja 1.0.0-beta01

13 października 2021 r.

androidx.wear.tiles:tiles-*:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Poprawki błędów

  • Naprawiono błąd NullPointerException w TileUiClient, gdy podano pustą wersję zasobu. (I0586e)

Wersja 1.0.0-alpha12

29 września 2021 r.

androidx.wear.tiles:tiles-*:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alfa12 zawiera te zatwierdzenia.

Poprawki błędów

  • Funkcja UpdateScheduler nie używa już słabego odwołania. Rozwiązano problemy, które powodowały, że TileUiClient nie aktualizował się(I1120d, b/199061124).

  • Zadeklaruj, że SysUiTileUpdateRequester wysyła zapytania do PackageManagera. Rozwiązuje to błąd, który powodował, że aktualizacje kafelków nie działały na urządzeniach R+. (I1120d)

Wersja 1.0.0-alpha11

1 września 2021 roku

Usługa androidx.wear.tiles:tiles-*:1.0.0-alpha11 została zwolniona. Wersja 1.0.0-alpha11 zawiera te commity.

Nowe funkcje

  • Dodaliśmy i opublikowaliśmy bibliotekę testową androidx.wear.tiles:tiles-testing, aby ułatwić deweloperom testowanie kafelków. (Iedb6b)

Zmiany interfejsu API

  • Nazwa usługi TileProviderService została zmieniona na TileService. (I1ad2c).
  • Zaktualizowano konstruktory kafelków. Statyczne metody .builder() zostały wycofane na rzecz wywołania new Foo.Builder(), a przeciążenia settera, które przyjmowały instancję Builder, zostały usunięte. (Ia9606)
  • Komponent TileRenderer powinien teraz używać kontekstu interfejsu użytkownika zamiast kontekstu aplikacji. (I84b61)

Poprawki błędów

  • Naprawiono błąd, który w pewnych sytuacjach powodował stosowanie podwójnego podkreślenia. (Ib6712)

Wersja 1.0.0-alpha10

18 sierpnia 2021 r.

androidx.wear.tiles:tiles:1.0.0-alpha10, androidx.wear.tiles:tiles-proto:1.0.0-alpha10 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 zostały udostępnione. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Usunięto sprawdzanie układu z publicznego interfejsu API. Te opcje są zawsze włączone, ale wyświetlają ostrzeżenie tylko wtedy, gdy sprawdzanie się nie powiedzie. (Ie9f29)
  • Komponent TileRenderer przyjmuje teraz kontekst interfejsu użytkownika zamiast kontekstu aplikacji.

Poprawki błędów

  • Naprawiono błąd uniemożliwiający klikanie elementów klikalnych w elementach rozszerzalnych.

Wersja 1.0.0-alpha09

21 lipca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha09, androidx.wear.tiles:tiles-proto:1.0.0-alpha09 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 są dostępne. Wersja 1.0.0-alpha09 zawiera te commity.

Nowe funkcje

  • Dodano sprawdzanie układu do renderowania kart na Wear. (I3a869).
    • Służą one do weryfikowania sprawdzonych metod w kafelku. Na początek, jeśli kafelek nie zawiera żadnych elementów z modyfikatorem Semantics, pojawi się ostrzeżenie.
  • Dodaliśmy dokumentację dotyczącą DefaultTileProviderClient i TestingTileProviderClient constructors. (I9f4b9)

Zmiany w interfejsie API

  • Zmiana nazwy w elemencie TileProviderClient (I0ec36):
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Dodano sprawdzanie układu do renderowania kart na Wear. (I3a869)

Poprawki błędów

  • Upewnij się, że element docelowy LaunchAction nie ma specjalnych uprawnień. (I39136)

Wersja 1.0.0-alpha08

30 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha08, androidx.wear.tiles:tiles-proto:1.0.0-alpha08 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 są dostępne. Wersja 1.0.0-alfa08 zawiera te zatwierdzenia.

Nowe funkcje

  • Elementy rozciągające obsługują teraz atrybuty line_height zamiast line_spacing.

Zmiany w interfejsie API

  • Dodano obsługę atrybutu line_height w elementach rozszerzalnych, usunięto atrybut line_spacing. (Ibeb54)
    • Kod korzystający z line_spacing należy przeportować, aby używał zamiast tego line_height.

Poprawki błędów

  • Naprawiono błąd związany z użyciem wymiarów proporcjonalnych. (I37ace)
  • Naprawiono błąd uniemożliwiający wyświetlanie opisów treści w elementach tekstowych. (Id2c7d).

Wersja 1.0.0-alpha07

16 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha07, androidx.wear.tiles:tiles-proto:1.0.0-alpha07 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 są dostępne. Wersja 1.0.0-alfa07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

  • Dodaj interfejs TileProviderClient i wyświetl DefaultTileProviderClient, aby umożliwić implementacjom wiązanie się z interfejsem TileProviderService. (I69165)

Wersja 1.0.0-alpha06

2 czerwca 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha06, androidx.wear.tiles:tiles-proto:1.0.0-alpha06 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 są dostępne. Wersja 1.0.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

  • Wszystkie klasy Builder zawierają teraz metody getter dla wszystkich właściwości. Pamiętaj, że są one przeznaczone tylko do celów testowych (I9d155).
  • Zmiana pakietu: zajęcia z androidx.wear.tiles.builders zostały przeniesione na listę androidx.wear.tiles.
  • Dodanie eksperymentalnej obsługi barwienia do kafelków. (I38929)
  • Nazwa LayoutElementBuilders.HALIGN_* została zmieniona na LayoutElementBuilders.HORIZONTAL_ALIGN_* (I67e58)
  • Nazwa LayoutElementBuilders.VALIGN_* została zmieniona na LayoutElementBuilders.VERTICAL_ALIGN_* (I67e58)
  • Nazwa LayoutElementBuilders.SPAN_VALIGN_* została zmieniona na LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* (I67e58).
  • Dodaliśmy klasy konstruktorów dla żądań i zdarzeń. (Ib5cf4)
  • Przeniesiono funkcję TileProviderService, aby umożliwić korzystanie z klas żądań i zdarzeń z klas RequestBuilders i EventBuilders, a nie z RequestReaders/EventReaders (np. onTileRequest udostępnia teraz wartość RequestBuilders.TileRequest, a nie RequestReaders.TileRequest). (I46ea1)

Poprawki błędów

  • Naprawiono błąd asynchronicznego wczytywania obrazów w mechanizmie renderowania kafelków. (Iad9b0)
  • Usunięto błąd układu podczas umieszczania obrazu o szerokości lub wysokości expand() w elementach Box o szerokości lub wysokości wrap(). (I33770)

Wersja 1.0.0-alpha05

18 maja 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha05, androidx.wear.tiles:tiles-proto:1.0.0-alpha05 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te commity.

Zmiany interfejsu API

  • Usunięto getTileId z przychodzących zdarzeń dotyczących kafelków (TileAddEvent, TileRemoveEvent, TileEnterEvent, TileLeaveEvent, TileRequest). (Ifbba2)
  • Nazwa ImageResource#setAndroidResourceByResid została zmieniona na setAndroidResourceByResId (I4ba6e)
  • Zmieniliśmy nazwę TimelineManager#deInit na AutoCloseable i wdrożony (I5dff2)

Wersja 1.0.0-alpha04

5 maja 2021 roku

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha04, androidx.wear.tiles:tiles-proto:1.0.0-alpha04 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te commity.

Zmiany interfejsu API

  • Ukryte konkretne klasy TileProviderService.
    • Zmiana metody TileUpdateRequester na Class<? extends TileProviderService>. (Ib7cca)
  • Dodano możliwość dodawania dodatkowych elementów do klasy AndroidActivity. (I748f4)

Wersja kart 1.0.0-alpha03

21 kwietnia 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha03, androidx.wear.tiles:tiles-proto:1.0.0-alpha03 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

  • Zmień nazwę TileManager -> TileClient
    • Zmień nazwę TileManager#create -> TileClient#connect (I91839)

Poprawki błędów

  • Dodano reguły ProGuard, które zapewniają prawidłowe działanie tiles i tiles-renderer z włączoną funkcją Proguard (Ie3d85)

Wersja 1.0.0-alpha02

7 kwietnia 2021 r.

Funkcje androidx.wear.tiles:tiles:1.0.0-alpha02, androidx.wear.tiles:tiles-proto:1.0.0-alpha02 i androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te commity.

Zmiany interfejsu API

  • androidx.wear:wear-tiles przeniósł grupy i od teraz powinien być nazywany androidx.wear.tiles:tiles
  • Grupa androidx.wear:wear-tiles-renderer została przeniesiona i ma teraz nazwę androidx.wear.tiles:tiles-renderer
  • Funkcja TileRenderer.LoadActionListener używa teraz instancji androidx.wear.tiles.builders.StateBuilders.State, a nie androidx.wear.tiles.proto.StateProto.State.
  • TileRenderer obsługuje teraz zasoby kafelka z poziomu androidx.wear.tiles.builders.ResourceBuilders.Resources, a nie z poziomu androidx.wear.tiles.renderer.ResourceAccessors.

Poprawki błędów

  • Rozwiązano problem z niemożliwością użycia funkcji LoadActionListener, ponieważ ujawniała ona wewnętrzną klasę.

Wersja 1.0.0-alpha01

10 marca 2021 r.

Funkcje androidx.wear:wear-tiles:1.0.0-alpha01, androidx.wear:wear-tiles-proto:1.0.0-alpha01 i androidx.wear:wear-tiles-renderer:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

  • Biblioteka Wear Tiles Renderer zapewnia funkcje do tworzenia niestandardowych kafelków na urządzeniach z Wear OS oraz klasy, które umożliwiają systemowi pobieranie i wyświetlanie kafelka obok tarczy zegarka.